Documentation – Робота з SMTP клієнтом

Net: Підключення до SMTP-сервера

Mon, 01 Jan 0001 00:00:00 +0000

Оптимізація підключень поштового клієнта

Користувачі часто стикаються зі затримками через типові налаштування тайм‑ауту, що може призвести до тривалих часів підключення або навіть невдалих спроб.

Щоб підвищити ефективність цих підключень, Aspose.Email для .NET пропонує такі властивості, як Тайм-аут і GreetingTimeout. Хоча Timeout властивість керує загальною тривалістю операцій електронної пошти, GreetingTimeout властивість спеціально орієнтована на час, потрібний серверу для надсилання рядка привітання під час підключення.

У наступному розділі ми розглянемо, як налаштувати ці параметри, щоб підвищити швидкість та надійність підключення вашого поштового клієнта.

При використанні Timeout властивість, важливо зазначити, що значення, які їй присвоюються, повинні мати достатньо довгі інтервали, щоб дозволити тривалі операції.

Проте, спираючись лише на цю властивість, можна змусити встановлення з’єднання займати більше часу, ніж очікувалося. Це може траплятися, коли поштовий клієнт використовує автоматичний режим встановлення з’єднання. У цьому режимі клієнт перебирає різні параметри підключення, доки з’єднання не буде встановлено.

При підключенні до серверів SMTP, IMAP та POP3 сервер надсилає клієнту рядок привітання після успішного встановлення з’єднання. Сервери можуть ініціювати SSL/TLS з’єднання явно або неявно (START TLS). У випадках, коли режим з’єднання не відповідає (наприклад, сервер очікує неявного SSL з’єднання, а клієнт намагається встановити незашифроване або явне SSL з’єднання), сервер не надсилатиме рядок привітання.

В результаті користувач може чекати тривалий час, доки не спрацює тайм‑аут, і клієнт переходить до наступного варіанту підключення.

Щоб вирішити цю проблему, GreetingTimeout властивість була додана. Ця властивість дозволяє користувачам встановити тайм‑аут для рядка привітання, скорочуючи час, необхідний для автоматичного встановлення з’єднання. Реалізуючи GreetingTimeout властивість, користувачі можуть оптимізувати продуктивність свого поштового клієнта та уникнути тривалих очікувань під час встановлення з’єднання.

Наступний приклад коду показує, як встановити EmailClient.GreetingTimeout властивість:

using (SmtpClient client = new SmtpClient("localhost", 25, "username", "password"))
{
    client.GreetingTimeout = 4000;
}

Отримати розширення сервера

The SmtpClient дозволяє отримати розширення сервера, які підтримуються, такі як IDLE, UNSELECT, QUOTA тощо. Це допомагає визначити наявність розширення перед використанням клієнта для конкретної функції. The GetCapabilities() метод повертає підтримувані типи розширень у вигляді масиву рядків.

Наступний фрагмент коду показує, як отримати розширення сервера.

Перевірка облікових даних поштового сервера без надсилання листів

API Aspose.Email надає можливість перевіряти облікові дані поштового сервера без надсилання листа. Це можна здійснити за допомогою ValidateCredentials метод, що відповідає за перевірку автентичності та коректності наданих облікових даних електронної пошти, які зазвичай використовуються для автентифікації під час підключення до сервера.

Він перевіряє, чи надані облікові дані електронної пошти, такі як ім’я користувача та пароль, є дійсними, і чи може клієнт успішно підключитися до сервера. Це підтвердження облікових даних допомагає гарантувати, що клієнт може безпечно отримати доступ до поштового акаунту та виконати різні операції, наприклад надсилання листів.

using (SmtpClient client = new SmtpClient(server.SmtpUrl, server.SmtpPort, "username", "password", SecurityOptions.Auto))
{
    client.Timeout = 4000;
   
    if (client.ValidateCredentials())
    {
        //to do something
    }
}

Існує також версія методу ValidateCredentialsAsync для виконання асинхронної операції.

Надсилання листа через SOCKS‑проксі сервер

У таких випадках поштові клієнти не можуть комунікувати через інтернет без вказання адреси проксі. Aspose.Email підтримує версії 4, 4a та 5 протоколу SOCKS. Щоб надіслати лист через проксі‑сервер, виконайте наступні кроки:

Ініціалізуйте проксі з необхідною інформацією, тобто адресою проксі, портом і версією SOCKS.
Ініціалізувати SmtpClient з адресою хоста, ім’ям користувача та паролем, а також будь‑якими іншими налаштуваннями.
Встановіть властивість Proxy клієнта в Проксі об’єкт, створений раніше.

Нижче наведено код, який показує, як підключитися до сервера через проксі‑сервер.

Надсилання листа через HTTP‑проксі сервер

Визначення методів автентифікації для захищеного підключення SMTP

Aspose.Email пропонує властивості, що дозволяють перевірити, які методи автентифікації можна використовувати для встановлення захищеного з’єднання з сервером SMTP перед надсиланням листа:

це SmtpClient.SupportedAuthentication властивість повертає список методів автентифікації, підтримуваних сервером SMTP.
це SmtpClient.AllowedAuthentication властивість повертає список методів автентифікації, визначених користувачем.

smtpClient.AllowedAuthentication = SmtpKnownAuthenticationType.Login;

Завантаження даних автентифікації SMTP з файлу CONFIG

Щоб Aspose.Email могла читати файл конфігурації, він має бути у правильному форматі. Нижче наведено приклад XML‑файлу конфігурації та код, що його читає. Наступний фрагмент коду показує, як завантажити дані автентифікації SMTP з файлу CONFIG.

Після визначення параметрів конфігурації, завантажте їх безпосередньо в екземпляр SmtpClient клас, що використовує один із його перевантажених конструкторів. Наступний фрагмент коду демонструє читання налаштувань конфігурації з файлу та їх безпосереднє завантаження в екземпляр SmtpClient.

Прив’язка SMTP‑клієнта до конкретної IP‑адреси

Можливість того, що у хоста є кілька портів, доступних для надсилання електронних листів, не можна виключати. У таких випадках може виникнути потреба прив’язати клієнт відправки листів до конкретного порту на хості. Це можна досягти за допомогою Aspose.Email API, використовуючи SmtpClient BindIPEndPoint властивість. API SmtpClient можна встановити використання конкретної IP-адреси на хості, вказавши конкретну IP-Endpoint. Нижче наведено код, який показує, як прив’язати SMTP‑клієнт до конкретної IP‑адреси на хості.

Встановлення тайм‑ауту для поштових операцій

Кожна поштові операція займає певний час залежно від багатьох факторів (затримки мережі, розмір даних, продуктивність сервера тощо). Ви можете встановити тайм-аут для всіх поштових операцій. Нижче наведено приклад коду, який демонструє, як це зробити за допомогою Тайм-аут властивість.

Примітка: не варто задавати великі значення, щоб уникнути тривалих очікувань у вашому застосунку.

using (SmtpClient smtpClient = new SmtpClient("host", 587, "username", "password", SecurityOptions.SSLExplicit))
{
    smtpClient.Timeout = 60000; // 60 seconds

    // some code...
}

Використання криптографічних протоколів

Aspose.Email підтримує криптографічні протоколи SSL (застарілий) та TLS для забезпечення безпеки зв’язку. Ви можете ввімкнути криптографічне шифрування, щоб захистити обмін даними між вашим застосунком та поштовими серверами.

Примітка: Ви повинні встановлювати лише ті версії протоколу, які підтримуються .NET Framework. Якщо деякі версії криптографічного протоколу не підтримуються вашою поточною версією .NET Framework, вони будуть проігноровані та пропущені. У цьому випадку виключення не генеруватимуться. Будь ласка, використовуйте SetSupportedEncryptionUnsafe метод, якщо ви хочете встановити протоколи без будь‑яких перевірок сумісності.

Нижче наведений приклад коду, який показує, як встановити TLS 1.3 для SmtpClient екземпляр класу.

using (SmtpClient smtpClient = new SmtpClient("host", 587, "username", "password", SecurityOptions.SSLExplicit))
{
    smtpClient.SupportedEncryption = EncryptionProtocols.Tls13;

    // some code...
}

У випадку, коли зазначений протокол шифрування не підтримується у поточній версії .NET Framework, різниця в поведінці між SetSupportedEncryptionUnsafe метод і SupportedEncryption властивість має таке значення:

Якщо SupportedEncryption при використанні властивості клієнт пошти знижує протокол шифрування до підтримуваного рівня.
Якщо SetSupportedEncryptionUnsafe при використанні методу клієнт пошти викидає виключення.

SMTP‑автентифікація з механізмом CRAM-MD5

Механізм автентифікації CRAM-MD5 у Aspose.Email для .NET забезпечує додатковий рівень безпеки при доступі до сервера. Наступний фрагмент коду показує, як реалізувати цю функцію у вашому проєкті:

smtpClient.AllowedAuthentication = SmtpKnownAuthenticationType.CramMD5;

Net: Надсилання листів та пересилання повідомлень за допомогою SMTP‑клієнта в C#

Mon, 01 Jan 0001 00:00:00 +0000

Надсилання листів

Надсилати листи за допомогою класу SmtpClient

The SmtpClient клас дозволяє програмам надсилати листи через протокол Simple Mail Transfer Protocol (SMTP).

Однією з ключових можливостей є здатність надсилання повідомлень масово.

Він також повністю підтримує синхронний і асинхронний програмні моделі. Щоб передати лист, блокуючи основний потік до завершення операції, розробники можуть використовувати один з синхронних Надіслати методах. Альтернативно, щоб дозволити основному потоку продовжувати виконання, поки лист надсилається, розробники можуть використовувати SendAsync метод.

Крім того, SmtpClient підтримує надсилання повідомлень у Transport Neutral Encapsulation Format (TNEF).

Синхронне надсилання листів

Електронне повідомлення можна надіслати синхронно, використовуючи Надіслати метод SmtpClient клас. Він надсилає вказане повідомлення електронної пошти через SMTP‑сервер для доставки. Щоб надіслати лист синхронно, виконайте наведені нижче кроки:

Створіть екземпляр MailMessage клас і встановіть його властивості.
Створіть екземпляр SmtpClient клас і вкажіть хост, порт, ім’я користувача та пароль.
Надішліть повідомлення за допомогою Надіслати метод SmtpClient клас і передати MailMessage екземпляр.

Наведений нижче фрагмент коду C# показує, як надсилати листи Outlook синхронно.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Declare msg as MailMessage instance
MailMessage msg = new MailMessage();

// Create an instance of SmtpClient class
SmtpClient client = new SmtpClient();

// Specify your mailing host server, Username, Password, Port # and Security option
client.Host = "mail.server.com";
client.Username = "username";
client.Password = "password";
client.Port = 587;
client.SecurityOptions = SecurityOptions.SSLExplicit;

try
{
    // Client.Send will send this message
    client.Send(msg);
    Console.WriteLine("Message sent");
}
catch (Exception ex)
{
    Trace.WriteLine(ex.ToString());
}

Надсилати листи асинхронно

Інколи ви можете захотіти надсилати листи асинхронно, щоб програма продовжувала виконувати інші операції, поки лист надсилається у фоні. Починаючи з .NET Framework 4.5, ви можете використовувати асинхронні методи, реалізовані згідно з TAP модель. Наведений нижче фрагмент коду C# показує, як надсилати повідомлення Outlook, використовуючи методи на основі патерну асинхронних завдань:

SendAsync Надсилає вказані повідомлення.
IAsyncSmtpClient - Дозволяє застосункам надсилати повідомлення за допомогою протоколу Simple Mail Transfer Protocol (SMTP).
SmtpClient.CreateAsync - Створює новий екземпляр класу Aspose.Email.Clients.Smtp.SmtpClient
SmtpSend - Параметри методу Aspose.Email.Clients.Smtp.IAsyncSmtpClient.SendAsync(Aspose.Email.Clients.Smtp.Models.SmtpSend).
SmtpForward - Параметри Aspose.Email.Clients.Smtp.IAsyncSmtpClient.ForwardAsync(Aspose.Email.Clients.Smtp.Models.SmtpForward).

// Authenticate the client to obtain necessary permissions
static readonly string tenantId = "YOU_TENANT_ID";
static readonly string clientId = "YOU_CLIENT_ID";
static readonly string redirectUri = "http://localhost";
static readonly string username = "username";
static readonly string[] scopes = { "https://outlook.office.com/SMTP.Send" };

// Use the SmtpAsync method for asynchronous operations
static async Task Main(string[] args)
{
    await SmtpAsync();
    Console.ReadLine();
}

static async Task SmtpAsync()
{
    // Create token provider and get access token
    var tokenProvider = new TokenProvider(clientId, tenantId, redirectUri, scopes);
    var client = SmtpClient.CreateAsync("outlook.office365.com", username, tokenProvider, 587).GetAwaiter().GetResult();

    // Create a message to send
    var eml = new MailMessage("from@domain.com", "to@domain.com", "test subj async", "test body async");
    
    // send message
    var sendOptions = SmtpSend.Create();
    sendOptions.AddMessage(eml);
    await client.SendAsync(sendOptions);
    Console.WriteLine("message was sent");

    // forward message
    var fwdOptions = SmtpForward.Create();
    fwdOptions.SetMessage(eml);
    fwdOptions.AddRecipient("rec@domain.com");
    await client.ForwardAsync(fwdOptions);
    Console.WriteLine("message was forwarded");
}

// Token provider implementation
public class TokenProvider : IAsyncTokenProvider
{
    private readonly PublicClientApplicationOptions _pcaOptions;
    private readonly string[] _scopes;

    public TokenProvider(string clientId, string tenantId, string redirectUri, string[] scopes)
    {
        _pcaOptions = new PublicClientApplicationOptions
        {
            ClientId = clientId,
            TenantId = tenantId,
            RedirectUri = redirectUri
        };

        _scopes = scopes;
    }

    public async Task<OAuthToken> GetAccessTokenAsync(bool ignoreExistingToken = false, CancellationToken cancellationToken = default)
    {

        var pca = PublicClientApplicationBuilder
            .CreateWithApplicationOptions(_pcaOptions).Build();

        try
        {
            var result = await pca.AcquireTokenInteractive(_scopes)
                .WithUseEmbeddedWebView(false)
                .ExecuteAsync(cancellationToken);

            return new OAuthToken(result.AccessToken);
        }
        catch (MsalException ex)
        {
            Console.WriteLine($"Error acquiring access token: {ex}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex}");
        }

        return null;
    }

    public void Dispose()
    {

    }
}

Надсилати повідомлення з диска

Файли EML містять заголовок, тіло повідомлення та вкладення. Aspose.Email дозволяє розробникам працювати з файлами EML різними способами. Цей розділ показує, як завантажити файли EML з диска та надіслати їх як листи за допомогою SMTP. Ви можете завантажити .eml файли з диска або потоку у MailMessage клас і надішліть повідомлення, використовуючи SmtpClient клас. The MailMessage клас є основним класом для створення нових електронних листів, завантаження файлів листів з диска або потоку та збереження повідомлень. Наведений нижче фрагмент коду C# показує, як надсилати збережені повідомлення з диска.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Load an EML file in MailMessage class
var message = MailMessage.Load(dataDir + "test.eml");

// Send this message using SmtpClient
var client = new SmtpClient("host", "username", "password");
            
try
{
    client.Send(message);
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}

Надсилати листи у простому тексті

The Тіло властивість, властивість MailMessage клас, який використовується для вказання простого текстового вмісту тіла повідомлення. Щоб надіслати лист у форматі простого тексту, виконайте наступні кроки:

Створіть екземпляр MailMessage клас.
Вкажіть електронну адресу відправника та одержувача у MailMessage екземпляр.
Вкажіть Тіло вміст, що використовується для простого текстового повідомлення.
Створіть екземпляр SmtpClient клас і надішліть лист.

У наведеному фрагменті коду показано, як надіслати лист у форматі простого тексту.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
//Create an instance of the MailMessage class
var message = new MailMessage();

// Set From field, To field and Plain text body
message.From = "sender@sender.com";
message.To.Add("receiver@receiver.com");
message.Body = "This is Plain Text Body";

// Create an instance of the SmtpClient class
var client = new SmtpClient();

// And Specify your mailing host server, Username, Password and Port
client.Host = "smtp.server.com";
client.Username = "Username";
client.Password = "Password";
client.Port = 25;

try
{
    //Client.Send will send this message
    client.Send(message);
    Console.WriteLine("Message sent");
}
catch (Exception ex)
{
    System.Diagnostics.Trace.WriteLine(ex.ToString());
}

Надсилати листи з HTML‑тілом

Нижче наведені приклади коду демонструють, як можна надіслати простий HTML‑лист. HtmlBody, властивість MailMessage клас, який використовується для вказання HTML‑вмісту тіла повідомлення. Щоб надіслати простий HTML‑лист, виконайте наступні кроки:

Створіть екземпляр MailMessage клас.
Вкажіть електронну адресу відправника та одержувача у MailMessage екземпляр.
Вкажіть HtmlBody вміст.
Створіть екземпляр SmtpClient клас і надішліть лист, використовуючи Надіслати метод.

Для цілей цієї статті HTML‑вміст листа є простим: This is the HTML body Більшість HTML‑листів буде складнішими. Наведений нижче фрагмент коду показує, як надіслати лист з HTML‑тілом.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public static void Run()
{
    // Declare msg as MailMessage instance
    var msg = new MailMessage();

    // Use MailMessage properties like specify sender, recipient, message and HtmlBody
    msg.From = "newcustomeronnet@gmail.com";
    msg.To = "asposetest123@gmail.com";
    msg.Subject = "Test subject";
    msg.HtmlBody = "<html><body>This is the HTML body</body></html>";

    var client = GetSmtpClient();

    try
    {
        // Client will send this message
        client.Send(msg);
        Console.WriteLine("Message sent");
    }
    catch (Exception ex)
    {
        Trace.WriteLine(ex.ToString());
    }

    Console.WriteLine(Environment.NewLine + "Email sent with HTML body.");
}

private static SmtpClient GetSmtpClient()
{
    var client = new SmtpClient("smtp.gmail.com", 587, "your.email@gmail.com", "your.password");
    client.SecurityOptions = SecurityOptions.Auto;
    return client;
}

Надсилати HTML‑листи з альтернативним текстом

Використайте AlternateView клас для вказання копій електронного листа в різних форматах. Наприклад, якщо ви надсилаєте повідомлення у форматі HTML, ви також можете надати версію у вигляді простого тексту для одержувачів, які користуються поштовими клієнтами, що не підтримують HTML. Або, якщо ви надсилаєте розсилку, ви можете надати простий текстовий варіант для тих одержувачів, які обрали отримання простого тексту. Щоб надіслати електронний лист з альтернативним текстом, виконайте наступні кроки:

Створіть екземпляр MailMessage клас.
Вкажіть електронні адреси відправника та одержувача у MailMessage екземпляр.
Створіть екземпляр AlternateView клас.

Це створює альтернативний вигляд електронного листа, використовуючи вміст, заданий у рядку.

Додайте екземпляр AlternateView клас до MailMessage об’єкт.
Створіть екземпляр SmtpClient клас і надішліть лист, використовуючи Надіслати метод.

У наведеному фрагменті коду показано, як надіслати електронний лист з альтернативним текстом.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Declare message as MailMessage instance
var message = new MailMessage();

// Creates AlternateView to view an email message using the content specified in the //string
var alternate = AlternateView.CreateAlternateViewFromString("Alternate Text");
            
// Adding alternate text
message.AlternateViews.Add(alternate);

Надіслати масові листи

Ми можемо надіслати пакет листів, використовуючи SmtpClient клас Надіслати перевантаження методу, яке приймає MailMessageCollection:

Створіть екземпляр SmtpClient клас.
Вкажіть SmtpClient властивостей класу.
Створіть екземпляр MailMessage клас.
Вкажіть відправника, одержувача, тему листа та повідомлення у екземплярі MailMessage клас.
Повторіть вищевказані два кроки ще раз, якщо ви хочете надіслати листа іншій особі.
Створіть екземпляр MailMessageCollection клас.
Додайте екземпляр MailMessage клас в об’єкті MailMessageCollection клас.
Тепер надішліть ваш електронний лист, використовуючи SmtpClient клас Надіслати метод, передаючи екземпляр MailMessageCollection клас у цьому.

У наведеному фрагменті коду показано, як надсилати масові електронні листи.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create SmtpClient as client and specify server, port, user name and password
var client = new SmtpClient("mail.server.com", 25, "Username", "Password");

// Create instances of MailMessage class and Specify To, From, Subject and Message
var message1 = new MailMessage("msg1@from.com", "msg1@to.com", "Subject1", "message1, how are you?");
var message2 = new MailMessage("msg1@from.com", "msg2@to.com", "Subject2", "message2, how are you?");
var message3 = new MailMessage("msg1@from.com", "msg3@to.com", "Subject3", "message3, how are you?");

// Create an instance of MailMessageCollection class
var manyMsg = new MailMessageCollection();
manyMsg.Add(message1);
manyMsg.Add(message2);
manyMsg.Add(message3);

try
{
    // Send Messages using Send method
    client.Send(manyMsg);                
    Console.WriteLine("Message sent");
}
catch (Exception ex)
{
    Trace.WriteLine(ex.ToString());
}

Відстеження успішності масових листів

Коли ви надсилаєте повідомлення масово, ви можете отримати інформацію про кількість успішно надісланих повідомлень і навіть отримати список цих повідомлень. The SucceededSending подія для цієї мети.

Зразок коду:

using (var client = new SmtpClient(host, SecurityOptions.Auto))
{
    int messageCount = 0;

    client.SucceededSending += (sender, eventArgs) =>
    {
        Console.WriteLine("The message '{0}' was successfully sent.", eventArgs.Message.Subject);
        messageCount++;
    };

    client.Send(messages);

    Console.WriteLine("{0} messages were successfully sent.", messageCount);
}

Надсилання листів з багатоз’єднанням

The UseMultiConnection властивість можна використати для створення декількох з’єднань для інтенсивних операцій. Ви також можете встановити кількість з’єднань, що використовуються під час режиму багатоз’єднання, за допомогою SmtpClient.ConnectionsQuantity. У наведеному фрагменті коду продемонстровано використання режиму багатоз’єднання для надсилання кількох повідомлень.

var smtpClient = new SmtpClient();
smtpClient.Host = "<HOST>";
smtpClient.Username = "<USERNAME>";
smtpClient.Password = "<PASSWORD>";
smtpClient.Port = 587;
smtpClient.SupportedEncryption = EncryptionProtocols.Tls;
smtpClient.SecurityOptions = SecurityOptions.SSLExplicit;

var messages = new List<MailMessage>();
for (int i = 0; i < 20; i++)
{
    MailMessage message = new MailMessage(
        "<EMAIL ADDRESS>",
        "<EMAIL ADDRESS>",
        "Test Message - " + Guid.NewGuid().ToString(),
        "SMTP Send Messages with MultiConnection");
    messages.Add(message);
}

smtpClient.ConnectionsQuantity = 5;
smtpClient.UseMultiConnection = MultiConnectionMode.Enable;
smtpClient.Send(messages);

Зауважте, що використання режиму мультипідключення не гарантує підвищення продуктивності.

Надсилати листи у форматі TNEF

TNEF‑листи мають спеціальне форматування, яке може бути втрачено при надсиланні за допомогою стандартного API. The SmtpClient клас UseTnef властивість можна встановити, щоб надсилати лист у форматі TNEF. Наступний фрагмент коду показує, як надіслати повідомлення як TNEF.

var emlFileName = RunExamples.GetDataDir_Email() + "Message.eml";     // A TNEF Email

// Load from eml
var eml1 = MailMessage.Load(emlFileName, new EmlLoadOptions());
eml1.From = "somename@gmail.com";
eml1.To.Clear();
eml1.To.Add(new MailAddress("first.last@test.com"));
eml1.Subject = "With PreserveTnef flag during loading";
eml1.Date = DateTime.Now;

var client = new SmtpClient("smtp.gmail.com", 587, "somename", "password");
client.SecurityOptions = SecurityOptions.Auto;
client.UseTnef = true;     // Use this flag to send as TNEF
client.Send(eml1);

Надіслати запити на зустріч

Aspose.Email дозволяє розробникам додавати функції календаря до ваших листів.

Надсилати запити електронною поштою

Щоб надсилати запити на зустрічі електронною поштою, виконайте наступні кроки:

Створіть екземпляр MailMessage клас.
Вкажіть адреси відправника та одержувача, використовуючи екземпляр MailMessage клас.
Ініціалізуйте екземпляр Appointment клас і передайте його значення.
Вкажіть підсумок і опис у Calendar екземпляр.
Додайте Calendar до MailMessage екземпляр і передайте йому Appointment екземпляр.

|Запит на зустріч iCalendar, надісланий електронною поштою| | :- | || Наступний фрагмент коду показує, як надсилати запити через Email.


// Create an instance of the MailMessage class
var msg = new MailMessage();

// Set the sender, recipient, who will receive the meeting request. Basically, the recipient is the same as the meeting attendees
msg.From = "newcustomeronnet@gmail.com";
msg.To = "person1@domain.com, person2@domain.com, person3@domain.com, asposetest123@gmail.com";

// Create Appointment instance
var app = new Appointment("Room 112", new DateTime(2015, 7, 17, 13, 0, 0), new DateTime(2015, 7, 17, 14, 0, 0), msg.From, msg.To);
app.Summary = "Release Meetting";
app.Description = "Discuss for the next release";

// Add appointment to the message and Create an instance of SmtpClient class
msg.AddAlternateView(app.RequestApointment());
var client = GetSmtpClient();

try
{
    // Client.Send will send this message
    client.Send(msg);
    Console.WriteLine("Message sent");
}
catch (Exception ex)
{
    Trace.WriteLine(ex.ToString());
}

Пересилати повідомлення

Пересилати повідомлення за допомогою SMTP‑клієнта

Пересилання листа є поширеною практикою. Отриманий лист можна переслати конкретним одержувачам. The Переслати метод можна використовувати для перевідправлення отриманого або збереженого листа потрібним одержувачам. Наведений фрагмент коду показує, як переслати лист за допомогою SMTP‑клієнта.

//Create an instance of SmtpClient class
var client = new SmtpClient();

// Specify your mailing host server, Username, Password, Port and SecurityOptions
client.Host = "mail.server.com";
client.Username = "username";
client.Password = "password";
client.Port = 587;
client.SecurityOptions = SecurityOptions.SSLExplicit;
var message = MailMessage.Load(dataDir + "Message.eml");
client.Forward("Recipient1@domain.com", "Recipient2@domain.com", message);

Пересилати повідомлення без MailMessage

API також підтримує пересилання EML-повідомлень без попереднього завантаження в MailMessage. Це корисно у випадках, коли доступно обмежені ресурси оперативної пам’яті.


using (var client = new SmtpClient(host, smtpPort, username, password, SecurityOptions.Auto))
{
    using (var fs = File.OpenRead(@"test.eml"))
    {
        client.Forward(sender, recipients, fs);
    }
}

Пересилати повідомлення асинхронно без MailMessage

using (var client = new SmtpClient(host, smtpPort, username, password))
{
    using (var fs = File.OpenRead(@"test.eml"))
    {
        await client.ForwardAsync(sender, recipients, fs);
    }
}

Поштове злиття

Як об’єднати листи

Злиття листів допомагає створювати та надсилати пакет подібних електронних листів. Основна частина листів однакова, але вміст можна персоналізувати. Зазвичай для персоналізації листа використовуються контактні дані одержувача (ім’я, прізвище, компанія тощо).

|Ілюстрація роботи злиття листів:| | :- | || Aspose.Email дозволяє розробникам налаштовувати злиття листів, які включають дані з різних джерел даних.

Щоб виконати злиття листів за допомогою Aspose.Email, виконайте такі кроки:

Створіть функцію з сигнатурою назви
Створіть екземпляр MailMessage клас.
Вкажіть відправника, одержувача, тему та тіло.
Створіть підпис для кінця листа.
Створіть екземпляр TemplateEngine класі і передайте йому MailMessage екземпляр.
Отримайте підпис у TemplateEngine екземпляр.
Створіть екземпляр класу DataTable.
Додайте стовпці Receipt, FirstName і LastName як джерела даних у клас DataTable.
Створіть екземпляр класу DataRow.
Вкажіть адресу отримувача, ім’я та прізвище у об’єкті DataRow.
Створіть екземпляр MailMessageCollection клас
Вкажіть TemplateEngine і екземплярів DataTable у MailMessageCollection екземпляр.
Створіть екземпляр SmtpClient клас і вкажіть сервер, порт, ім’я користувача та пароль.
Надсилати листи за допомогою SmtpClient клас Надіслати метод.

У наведеному нижче прикладі #FirstName# вказує на колонку DataTable, значення якої задає користувач. Наведений фрагмент коду показує, як виконати поштове злиття.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
public static void Run()
{
    // The path to the File directory.
    string dataDir = RunExamples.GetDataDir_SMTP();
    string dstEmail = dataDir + "EmbeddedImage.msg";

    // Create a new MailMessage instance
    MailMessage msg = new MailMessage();

    // Add subject and from address
    msg.Subject = "Hello, #FirstName#";
    msg.From = "sender@sender.com";

    // Add email address to send email also Add mesage field to HTML body
    msg.To.Add("your.email@gmail.com");
    msg.HtmlBody = "Your message here";
    msg.HtmlBody += "Thank you for your interest in <STRONG>Aspose.Email</STRONG>.";

    // Use GetSignment as the template routine, which will provide the same signature
    msg.HtmlBody += "<br><br>Have fun with it.<br><br>#GetSignature()#";

    // Create a new TemplateEngine with the MSG message,  Register GetSignature routine. It will be used in MSG.
    TemplateEngine engine = new TemplateEngine(msg);
    engine.RegisterRoutine("GetSignature", GetSignature);

    // Create an instance of DataTable and Fill a DataTable as data source
    DataTable dt = new DataTable();
    dt.Columns.Add("Receipt", typeof(string));
    dt.Columns.Add("FirstName", typeof(string));
    dt.Columns.Add("LastName", typeof(string));

    DataRow dr = dt.NewRow();
    dr["Receipt"] = "abc<asposetest123@gmail.com>";
    dr["FirstName"] = "a";
    dr["LastName"] = "bc";
    dt.Rows.Add(dr);
    dr = dt.NewRow();
    dr["Receipt"] = "John<email.2@gmail.com>";
    dr["FirstName"] = "John";
    dr["LastName"] = "Doe";
    dt.Rows.Add(dr);
    dr = dt.NewRow();
    dr["Receipt"] = "Third Recipient<email.3@gmail.com>";
    dr["FirstName"] = "Third";
    dr["LastName"] = "Recipient";
    dt.Rows.Add(dr);

    MailMessageCollection messages;
    try
    {
        // Create messages from the message and datasource.
        messages = engine.Instantiate(dt);

        // Create an instance of SmtpClient and specify server, port, username and password
        SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "your.email@gmail.com", "your.password");
        client.SecurityOptions = SecurityOptions.Auto;

        // Send messages in bulk
        client.Send(messages);
    }
    catch (MailException ex)
    {
        Debug.WriteLine(ex.ToString());
    }

    catch (SmtpException ex)
    {
        Debug.WriteLine(ex.ToString());
    }

    Console.WriteLine(Environment.NewLine + "Message sent after performing mail merge.");
}

// Template routine to provide signature
static object GetSignature(object[] args)
{
    return "Aspose.Email Team<br>Aspose Ltd.<br>" + DateTime.Now.ToShortDateString();
}

Як виконати поштове злиття по рядках

Користувач може об’єднати окремий рядок даних, а також отримати повний і готовий MailMessage об’єкт. The TemplateEngine.Merge метод можна використати для виконання порядкового злиття листів.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create message from the data in current row.
message = engine.Merge(currentRow);

Net: Увімкнути журналювання активності SMTP у .NET за допомогою appsettings.json

Mon, 01 Jan 0001 00:00:00 +0000

Журналювання активності використовується для налагодження, а також для збору та аналізу робочої інформації про SMTP‑клієнт.

Увімкнути логування активності

Використати файл appsettings.json для ввімкнення журналювання активності

Примітка: Цей параметр рекомендовано для .NET Core застосунків.

Вхід SmtpClient можна ввімкнути за допомогою наступних кроків і прикладів коду:

Додайте файл конфігурації appsettings.json до C#‑проекту, якщо його ще не додано.

Переконайтеся, що файл проекту містить наступні рядки у розділі ItemGroup.

   <Content Include="appsettings.json">
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
   </Content>

Потім додайте наступний вміст у файл appsettings.json.

   {
     "SmtpDiagnosticLog": "smtp.log",
     "SmtpDiagnosticLog_UseDate": true
   }

Дві вищезазначені властивості:

SmtpDiagnosticLog — вказує відносний або абсолютний шлях до файлу журналу.
SmtpDiagnosticLog_UseDate — вказує, чи додавати рядкове представлення поточної дати до імені файлу журналу.

Увімкнути журналювання активності у програмному коді

Ви також можете негайно ввімкнути журналювання у коді.

Примітка: навіть якщо ви вже ввімкнули журналювання за допомогою файлів конфігурації, цей параметр буде застосовано.

Вхід SmtpClient можна ввімкнути за допомогою наступних кроків і прикладів коду:

Створіть SmtpClient.
Встановіть шлях до файлу журналу, використовуючи LogFileName властивість.
Встановіть UseDateInLogFileName властивість, якщо це необхідно.

   using (var client = new SmtpClient("your smtp server"))
   {
       // Set username, password, port, and security options
       client.Username = "your username";
       client.Password = "your password";
       client.Port = 465;
       client.SecurityOptions = SecurityOptions.SSLImplicit;
   
       // Set the path to the log file using the LogFileName property.
       client.LogFileName = @"C:\Aspose.Email.Smtp.log";
       
       // Set the UseDateInLogFileName property if it is necessary.
       client.UseDateInLogFileName = false;
   
       var eml = new MailMessage("from address", "to address", "this is a test subject", "this is a test body");
   
       client.Send(eml);
   }

Використати файл App.config для ввімкнення журналювання активності

Активність SMTP‑клієнта можна журналювати, змінюючи configSections у конфігураційному файлі. Журнальне діагностичне логування можна виконати за допомогою наступних кроків:

Додайте групу розділів під назвою "applicationSettings".
Додайте розділ під назвою "Aspose.Email.Properties.Settings".
Включіть налаштування з назвою SmtpDiagonosticLog, де ім’я файлу визначено у applicationSettings/Aspose.Email.Properties.Settings

Ось приклад програми на основі форми, яка використовує SmtpClient для надсилання електронного листа. Уся ця діяльність журналюється шляхом зміни файлу App.config. Створіть форму з одним кнопкою. Додайте наступний код для обробника натискання кнопки:

Додайте посилання на Aspose.Email.

Додайте файл App.Config і змініть його таким чином, щоб вміст файлу був наступним

Для C# .NET використовуйте наступний варіант

Для VB .NET використовуйте наступний варіант

Запустіть код і перегляньте папку debug. Буде створений наступний файл.