Documentation – Работа с SMTP клиент

Net: Свързване към SMTP сървър

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

Оптимизация на връзките на имейл клиента

Потребителите често срещат закъснения поради настройките за таймаут по подразбиране, което може да доведе до продължително време за свързване или дори неуспешни опити.

За да подобрите ефективността на тези връзки, Aspose.Email за .NET предлага свойства като Време за изчакване и GreetingTimeout. Въпреки че Timeout свойство управлява общата продължителност за имейл операции, GreetingTimeout свойство, което конкретно цели времето, необходимо на сървъра да изпрати приветстващ низ при установяване на връзка.

В следващия раздел ще разгледаме как да конфигурираме тези настройки, за да подобрим скоростта и надеждността на връзката на вашия имейл клиент.

Когато използвате Timeout свойство, важно е да се отбележи, че стойностите, зададени на него, трябва да имат достатъчно дълги интервали, за да обслужват дълги операции.

Въпреки това, ако разчитате единствено на това свойство, установяването на връзка може да отнеме повече време от очакваното. Това може да се случи, когато имейл клиентът използва автоматичен режим за установяване на връзка. В този режим клиентът преминава през различни параметри на връзката, докато се установи връзка.

Когато се свързвате със SMTP, IMAP и POP3 сървъри, при успешно установяване на връзка се изпраща приветстващ низ към клиента. Сървърите могат да използват имплицитно или експлицитно (START TLS) иницииране на SSL/TLS връзка. В случаи, когато режимът на връзка не съвпада (например сървърът очаква имплицитна SSL връзка, а клиентът се опитва да установи небезопасна или експлицитна SSL връзка), сървърът няма да изпрати приветстващия низ.

В резултат потребителят може да чака продължително време, докато се достигне таймаутът, и клиентът преминава към следващата опция за връзка.

За да се справим с този проблем, GreetingTimeout свойство беше въведено. Това свойство позволява на потребителите да зададат таймаут за приветстващия низ, намалявайки времето, необходимо за установяване на автоматична връзка. Чрез прилагане на GreetingTimeout свойството, потребителите могат да оптимизират производителността на имейл клиента си и да избегнат дълги времена на изчакване по време на установяване на връзката.

Следният пример на код показва как да се зададе EmailClient.GreetingTimeout свойство:

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

Получаване на разширения на сървъра

Този SmtpClient ви позволява да извлечете разширенията, които сървърът поддържа, като IDLE, UNSELECT, QUOTA и др. Това помага за идентифициране на наличността на разширението преди да се използва клиентът за конкретната функция. The GetCapabilities() методът връща поддържаните типове разширения във формата на масив от низове.

Следният кодов фрагмент ви показва как да извлечете разширенията на сървъра.

Проверка на идентификационните данни на пощенския сървър без изпращане на имейли

Aspose.Email API предоставя възможност за проверка на идентификационните данни на пощенския сървър без изпращане на имейл. Това може да се постигне с 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 сървъра преди изпращане на имейл:

the SmtpClient.SupportedAuthentication свойството връща списък от методи за удостоверяване, поддържани от SMTP сървъра.
the SmtpClient.AllowedAuthentication свойството връща списък от методи за удостоверяване, дефинирани от потребителя.

smtpClient.AllowedAuthentication = SmtpKnownAuthenticationType.Login;

Зареждане на информация за SMTP удостоверяване от конфигурационен файл

За да може Aspose.Email да прочете конфигурационен файл, той трябва да е в правилния формат. По-долу показваме примерен XML конфигурационен файл, последван от кода, който го чете. Следният фрагмент от код показва как да заредите информация за SMTP удостоверяване от конфигурационен файл.

След като конфигурационните настройки са дефинирани, заредете ги директно в инстанция на SmtpClient клас, използващ един от претоварените си конструктори. Следният фрагмент от код демонстрира четене на конфигурационните настройки от конфигурационния файл и директно зареждане в инстанцията на SmtpClient.

Свързване на SMTP клиент към конкретен IP адрес

Възможността хостът да разполага с няколко налични портове за изпращане на имейли не може да бъде изключена. В такива случаи може да се появи необходимост да се свърже клиентът за изпращане на имейли към конкретен порт на хоста за изпращане на имейли. Това може да се постигне и чрез Aspose.Email API, използвайки SmtpClient BindIPEndPoint свойство. API‑то SmtpClient може да бъде зададено да използва конкретен IP адрес на хоста, като се посочи конкретната IP крайна точка. Следният кодов пример показва как да свържете 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

Този 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 клас. Този 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);
}

Изпращане на имейли в прост текст

Този Тяло свойство, свойство на 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);
}

Изпращане на имейли с MultiConnection

Този 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 заявка за среща, изпратена по имейл| | :- | || Следният кодов фрагмент ви показва как да изпратите заявки по имейл.


// 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);
    }
}

Mail Merge

Как да слеем имейли

Mail merge‑овете ви помагат да създадете и изпратите партида от сходни имейл съобщения. Основата на имейлите е еднаква, но съдържанието може да бъде персонализирано. Обикновено данните за контакт на получателя (име, фамилия, фирма и др.) се използват за персонализиране на имейла.

|Илюстрация как работи сливането на поща:| | :- | || Aspose.Email позволява на разработчиците да настройват сливане на поща, което включва данни от разнообразни източници.

За да извършите сливане на писма (mail merge) с Aspose.Email, изпълнете следните стъпки:

Създайте функция със сигнатурата на името
Създайте инстанция на MailMessage клас.
Посочете подател, получател, тема и тяло.
Създайте подпис за края на имейла.
Създайте инстанция на TemplateEngine клас и предайте му MailMessage екземпляр.
Вземете подписа в TemplateEngine екземпляр.
Създайте екземпляр на класа DataTable.
Добавете колоните Receipt, FirstName и LastName като източници на данни в класа DataTable.
Създайте екземпляр на класа DataRow.
Укажете адреса на получателя, както и името и фамилията в обекта DataRow.
Създайте инстанция на MailMessageCollection клас
Укажете TemplateEngine и екземпляри на DataTable в MailMessageCollection екземпляр.
Създайте инстанция на SmtpClient клас и посочете сървъра, порта, потребителското име и паролата.
Изпращайте имейли, използвайки SmtpClient клас Изпрати метод.

В примерa по-долу, #FirstName# обозначава колона от DataTable, чиято стойност се задава от потребителя. Следният кодов фрагмент ви показва как да извършите Mail Merge.

// 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 обект. Това 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. Ще бъде генериран следният файл.