Documentation – Làm việc với SMTP Client

Net: Kết nối tới Máy chủ SMTP

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

Tối ưu hóa kết nối trình khách Email

Người dùng thường gặp trễ do cài đặt thời gian chờ mặc định, điều này có thể dẫn đến thời gian kết nối kéo dài hoặc thậm chí thất bại.

Để cải thiện hiệu quả của các kết nối này, Aspose.Email cho .NET cung cấp các thuộc tính như Thời gian chờ và GreetingTimeout. Trong khi Timeout thuộc tính quản lý tổng thời gian cho các thao tác email, GreetingTimeout thuộc tính này nhắm mục tiêu cụ thể vào thời gian máy chủ cần để gửi chuỗi chào hỏi sau khi kết nối.

Trong phần tiếp theo, chúng tôi sẽ khám phá cách cấu hình các thiết lập này để nâng cao tốc độ và độ tin cậy kết nối của trình khách email của bạn.

Khi sử dụng Timeout thuộc tính, cần lưu ý rằng các giá trị được gán cho nó nên có khoảng thời gian đủ dài để đáp ứng các hoạt động kéo dài.

Tuy nhiên, chỉ dựa vào thuộc tính này có thể khiến quá trình thiết lập kết nối mất nhiều thời gian hơn dự kiến. Điều này có thể xảy ra khi trình khách email sử dụng chế độ tự động để thiết lập kết nối. Trong chế độ này, trình khách sẽ quay vòng qua nhiều tham số kết nối cho đến khi một kết nối được thiết lập.

Khi kết nối tới các máy chủ SMTP, IMAP và POP3, một chuỗi chào hỏi sẽ được gửi tới trình khách sau khi thiết lập kết nối thành công. Máy chủ có thể sử dụng khởi tạo kết nối SSL/TLS ngầm hoặc rõ ràng (START TLS). Trong những trường hợp chế độ kết nối không phù hợp (ví dụ, máy chủ mong đợi kết nối SSL ngầm trong khi trình khách cố gắng thiết lập kết nối không bảo mật hoặc SSL rõ ràng), máy chủ sẽ không gửi chuỗi chào hỏi.

Kết quả là, người dùng có thể phải chờ một khoảng thời gian dài cho đến khi hết thời gian chờ, và trình khách sẽ chuyển sang tùy chọn kết nối tiếp theo.

Để giải quyết vấn đề này, GreetingTimeout thuộc tính đã được giới thiệu. Thuộc tính này cho phép người dùng đặt thời gian chờ cho chuỗi chào hỏi, giảm thời gian cần thiết để thiết lập kết nối tự động. Bằng cách triển khai GreetingTimeout thuộc tính, người dùng có thể tối ưu hiệu năng của trình khách email và tránh thời gian chờ kéo dài trong quá trình thiết lập kết nối.

Mẫu mã sau đây cho thấy cách thiết lập EmailClient.GreetingTimeout thuộc tính:

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

Lấy Các Tiện ích Mở rộng của Máy chủ

Cái SmtpClient cho phép bạn lấy các phần mở rộng mà máy chủ hỗ trợ như IDLE, UNSELECT, QUOTA, v.v. Điều này giúp xác định tính khả dụng của một phần mở rộng trước khi sử dụng client cho chức năng cụ thể đó. The GetCapabilities() phương thức trả về các loại phần mở rộng được hỗ trợ dưới dạng mảng string.

Đoạn mã sau cho bạn thấy cách lấy các phần mở rộng của máy chủ.

Xác thực Thông tin Đăng nhập Máy chủ Mail mà Không Gửi Email

API Aspose.Email cung cấp khả năng xác thực thông tin đăng nhập máy chủ mail mà không cần gửi email. Điều này có thể thực hiện bằng ValidateCredentials phương thức chịu trách nhiệm xác minh tính xác thực và độ chính xác của các thông tin đăng nhập email đã cung cấp, thường được sử dụng để xác thực khi kết nối tới máy chủ.

Nó kiểm tra xem các thông tin đăng nhập email đã cung cấp, chẳng hạn như tên người dùng và mật khẩu, có hợp lệ hay không, và trình khách có thể thiết lập kết nối thành công tới máy chủ. Việc xác minh thông tin đăng nhập này giúp đảm bảo khách hàng có thể truy cập tài khoản email một cách an toàn và thực hiện các thao tác khác nhau, chẳng hạn như gửi email.

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

Cũng có một phiên bản của phương thức này ValidateCredentialsAsync để thực hiện một thao tác bất đồng bộ.

Gửi Email qua Máy Chủ Proxy SOCKS

Trong những trường hợp như vậy, trình khách mail không thể giao tiếp qua Internet nếu không chỉ định địa chỉ proxy. Aspose.Email hỗ trợ các phiên bản 4, 4a và 5 của giao thức proxy SOCKS. Để gửi email qua máy chủ proxy, thực hiện các bước sau:

Khởi tạo Proxy với thông tin cần thiết, gồm địa chỉ proxy, cổng và phiên bản SOCKS.
Khởi tạo SmtpClient với địa chỉ host, tên người dùng và mật khẩu, cùng bất kỳ cài đặt nào khác.
Đặt thuộc tính Proxy của trình khách thành Proxy đối tượng được tạo trước đó.

Đoạn mã dưới đây cho bạn thấy cách kết nối tới máy chủ thông qua máy chủ proxy.

Gửi Email qua Máy Chủ Proxy HTTP

Xác định Các Phương Thức Xác Thực cho Kết Nối SMTP Bảo Mật

Aspose.Email cung cấp các thuộc tính cho phép kiểm tra phương thức xác thực nào có thể được sử dụng để thiết lập kết nối bảo mật với máy chủ SMTP trước khi gửi email:

các SmtpClient.SupportedAuthentication thuộc tính trả về danh sách các phương thức xác thực được máy chủ SMTP hỗ trợ.
các SmtpClient.AllowedAuthentication thuộc tính trả về danh sách các phương thức xác thực do người dùng định nghĩa.

smtpClient.AllowedAuthentication = SmtpKnownAuthenticationType.Login;

Tải Thông Tin Xác Thực SMTP từ Tệp CONFIG

Để Aspose.Email có thể đọc tệp cấu hình, tệp đó phải ở định dạng đúng. Dưới đây, chúng tôi đưa ra một ví dụ tệp cấu hình XML và đoạn mã đọc nó. Đoạn mã sau đây cho thấy cách tải thông tin xác thực SMTP từ tệp CONFIG.

Khi các thiết lập cấu hình đã được xác định, tải chúng trực tiếp vào một thể hiện của SmtpClient lớp sử dụng một trong các hàm khởi tạo overload của nó. Đoạn mã sau đây minh họa cách đọc các thiết lập cấu hình từ tệp cấu hình và tải chúng trực tiếp vào một thể hiện của SmtpClient.

Gắn SMTP Client vào Địa chỉ IP Cụ Thể

Khả năng một máy chủ có nhiều cổng khả dụng để gửi email không thể loại trừ. Trong những trường hợp như vậy, có thể cần gắn client gửi email vào một cổng cụ thể trên máy chủ để gửi email. Điều này cũng có thể thực hiện được với Aspose.Email API bằng cách sử dụng SmtpClient BindIPEndPoint thuộc tính. API của SmtpClient có thể được đặt để sử dụng một địa chỉ IP cụ thể trên máy chủ bằng cách chỉ định IP Endpoint cụ thể. Đoạn mã dưới đây cho bạn thấy cách gắn SMTP Client vào Địa chỉ IP Cụ thể trên Máy chủ.

Đặt Thời Gian Chờ cho Các Thao Tác Mail

Mỗi thao tác mail mất một khoảng thời gian tùy thuộc vào nhiều yếu tố (độ trễ mạng, kích thước dữ liệu, hiệu suất máy chủ, v.v.). Bạn có thể đặt thời gian chờ cho tất cả các thao tác mail. Ví dụ mã dưới đây cho bạn thấy cách thực hiện điều đó bằng cách sử dụng Thời gian chờ thuộc tính.

Lưu ý: bạn không nên đặt giá trị quá lớn để tránh thời gian chờ lâu trong ứng dụng của mình.

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

    // some code...
}

Sử Dụng Các Giao Thức Mã Hóa

Aspose.Email hỗ trợ các giao thức mã hóa SSL (cũ) và TLS để cung cấp bảo mật giao tiếp. Bạn có thể bật mã hóa mật mã để bảo vệ việc trao đổi dữ liệu giữa ứng dụng của mình và máy chủ mail.

LƯU Ý: Bạn chỉ nên đặt các phiên bản giao thức mà .NET Framework hỗ trợ. Nếu một số phiên bản của giao thức mã hóa không được phiên bản .NET Framework hiện tại của bạn hỗ trợ, chúng sẽ bị bỏ qua và không gây ra ngoại lệ. Vui lòng sử dụng SetSupportedEncryptionUnsafe phương thức nếu bạn muốn đặt các giao thức mà không có kiểm tra tương thích nào.

Ví dụ mã dưới đây cho bạn cách thiết lập TLS 1.3 cho SmtpClient đối tượng lớp.

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

    // some code...
}

Trong trường hợp giao thức mã hóa được chỉ định không được hỗ trợ trong phiên bản hiện tại của .NET Framework, sự khác biệt trong hành vi giữa SetSupportedEncryptionUnsafe phương thức và SupportedEncryption thuộc tính như sau:

Nếu SupportedEncryption thuộc tính này được sử dụng, trình khách email hạ cấp giao thức mã hóa xuống mức hỗ trợ.
Nếu SetSupportedEncryptionUnsafe phương thức này được sử dụng, trình khách email sẽ ném ra ngoại lệ.

Xác Thực SMTP với Cơ Chế CRAM-MD5

Cơ chế xác thực CRAM-MD5 của Aspose.Email cho .NET cung cấp một lớp bảo mật bổ sung khi truy cập máy chủ. Đoạn mã sau đây cho thấy cách triển khai tính năng này vào dự án của bạn:

smtpClient.AllowedAuthentication = SmtpKnownAuthenticationType.CramMD5;

Net: Gửi Email & Chuyển tiếp Tin nhắn bằng SMTP Client trong C#

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

Gửi Email

Gửi Email bằng Lớp SmtpClient

Cái SmtpClient lớp cho phép các ứng dụng gửi email qua Giao thức Truyền Thông Đơn giản (SMTP).

Một trong những tính năng chính của nó là khả năng gửi tin nhắn hàng loạt.

Nó cũng hoàn toàn hỗ trợ đồng bộ và bất đồng bộ mô hình lập trình. Để truyền một email và chặn luồng chính cho đến khi thao tác hoàn thành, các nhà phát triển có thể sử dụng một trong các phương pháp đồng bộ Gửi phương pháp. Cuối cùng, để cho luồng chính tiếp tục thực thi trong khi email đang được gửi, các nhà phát triển có thể sử dụng SendAsync phương thức.

Thêm vào đó, SmtpClient hỗ trợ gửi tin nhắn ở dạng Định dạng đóng gói trung lập vận chuyển (TNEF).

Gửi Email Đồng bộ

Tin nhắn email có thể được gửi đồng bộ bằng cách sử dụng Gửi phương thức của SmtpClient lớp. Nó gửi tin nhắn email đã chỉ định qua một máy chủ SMTP để phân phối. Để gửi tin nhắn email một cách đồng bộ, thực hiện các bước sau:

Tạo một thể hiện của MailMessage lớp và đặt các thuộc tính của nó.
Tạo một thể hiện của SmtpClient lớp và chỉ định Host, port, tên người dùng & Mật khẩu.
Gửi Tin Nhắn bằng cách sử dụng Gửi phương thức của SmtpClient lớp và truyền vào MailMessage thể hiện.

Đoạn mã C# dưới đây cho bạn thấy cách gửi email Outlook một cách đồng bộ.

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

Gửi Email Bất đồng bộ

Đôi khi, bạn có thể muốn gửi mail bất đồng bộ để chương trình tiếp tục thực hiện các thao tác khác trong khi email đang được gửi ở nền. Bắt đầu từ .NET Framework 4.5, bạn có thể sử dụng các phương pháp bất đồng bộ được triển khai theo TAP model. Đoạn mã C# dưới đây cho thấy cách gửi các tin nhắn email Outlook bằng các phương thức dựa trên mô hình bất đồng bộ dạng task:

SendAsync Gửi các tin nhắn đã chỉ định.
IAsyncSmtpClient - Cho phép các ứng dụng gửi tin nhắn bằng giao thức Simple Mail Transfer Protocol (SMTP).
SmtpClient.CreateAsync - Tạo một thể hiện mới của lớp Aspose.Email.Clients.Smtp.SmtpClient
SmtpSend - Bộ tham số của phương thức Aspose.Email.Clients.Smtp.IAsyncSmtpClient.SendAsync(Aspose.Email.Clients.Smtp.Models.SmtpSend).
SmtpForward - Các đối số của 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()
    {

    }
}

Gửi Tin Nhắn Từ Đĩa

Các tệp EML chứa phần đầu, phần thân tin nhắn và tệp đính kèm. Aspose.Email cho phép các nhà phát triển làm việc với tệp EML theo các cách khác nhau. Phần này cho thấy cách tải tệp EML từ đĩa và gửi chúng dưới dạng email bằng SMTP. Bạn có thể tải các tệp .eml từ đĩa hoặc luồng vào MailMessage lớp và gửi tin nhắn email bằng cách sử dụng SmtpClient lớp. MailMessage lớp là lớp chính để tạo các tin nhắn email mới, tải các tệp tin nhắn email từ đĩa hoặc luồng và lưu các tin nhắn. Đoạn mã C# dưới đây cho thấy cách gửi các tin nhắn đã lưu từ đĩa.

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

Gửi Email ở Định dạng Văn bản Đơn

Cái Nội dung thuộc tính, một thuộc tính của MailMessage lớp, được dùng để chỉ định nội dung văn bản thuần của phần thân tin. Để gửi một tin nhắn email văn bản thuần, thực hiện các bước sau:

Tạo một đối tượng của MailMessage lớp.
Xác định địa chỉ email người gửi và người nhận trong MailMessage thể hiện.
Chỉ định Nội dung nội dung, dùng cho tin nhắn văn bản thuần.
Tạo một đối tượng của SmtpClient lớp và gửi email.

Đoạn mã dưới đây cho bạn thấy cách gửi email dạng văn bản thuần.

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

Gửi Email với Phần Thân HTML

Các mẫu lập trình dưới đây cho thấy cách bạn có thể gửi một tin nhắn email HTML đơn giản. HtmlBody, một thuộc tính của MailMessage lớp, được dùng để chỉ định nội dung HTML của phần thân tin nhắn. Để gửi một email HTML đơn giản, thực hiện các bước sau:

Tạo một đối tượng của MailMessage lớp.
Xác định địa chỉ email người gửi và người nhận trong MailMessage thể hiện.
Chỉ định HtmlBody nội dung.
Tạo một đối tượng của SmtpClient lớp và gửi email bằng cách sử dụng Gửi phương thức.

Với mục đích của bài viết này, nội dung HTML của email là đơn giản: This is the HTML body Hầu hết các email HTML sẽ phức tạp hơn. Đoạn mã dưới đây cho bạn thấy cách gửi một email với phần thân 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;
}

Gửi Email HTML với Văn bản Thay thế

Sử dụng AlternateView lớp để chỉ định các bản sao của tin nhắn email ở các định dạng khác nhau. Ví dụ, nếu bạn gửi tin nhắn dưới dạng HTML, bạn cũng có thể muốn cung cấp phiên bản văn bản thuần cho những người nhận dùng trình đọc email không hiển thị nội dung HTML. Hoặc, nếu bạn gửi bản tin, bạn có thể muốn cung cấp bản sao văn bản thuần cho những người nhận đã chọn nhận phiên bản văn bản thuần. Để gửi email với nội dung thay thế, thực hiện các bước sau:

Tạo một đối tượng của MailMessage lớp.
Xác định địa chỉ email người gửi và người nhận trong MailMessage thể hiện.
Tạo một đối tượng của AlternateView lớp.

Điều này tạo một chế độ xem thay thế cho tin nhắn email bằng nội dung được chỉ định trong chuỗi.

Thêm thể hiện của AlternateView lớp tới MailMessage đối tượng.
Tạo một đối tượng của SmtpClient lớp và gửi email bằng cách sử dụng Gửi phương thức.

Đoạn mã dưới đây cho bạn thấy cách gửi email với nội dung thay thế.

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

Gửi Email Hàng loạt

Chúng ta có thể gửi một loạt email bằng cách sử dụng SmtpClient lớp của Gửi phương thức overload chấp nhận một MailMessageCollection:

Tạo một thể hiện của SmtpClient lớp.
Chỉ định SmtpClient các thuộc tính của lớp.
Tạo một đối tượng của MailMessage lớp.
Xác định người gửi, người nhận, tiêu đề thư và nội dung trong thể hiện của MailMessage lớp.
Lặp lại hai bước trên một lần nữa, nếu bạn muốn gửi email cho người khác.
Tạo một thể hiện của MailMessageCollection lớp.
Thêm một thể hiện của MailMessage lớp trong đối tượng của MailMessageCollection lớp.
Bây giờ gửi email của bạn bằng cách sử dụng SmtpClient lớp Gửi phương thức bằng cách truyền thể hiện của MailMessageCollection lớp trong đó.

Đoạn mã dưới đây cho bạn thấy cách gửi email hàng loạt.

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

Theo dõi Thành công Email Hàng loạt

Khi bạn gửi tin nhắn hàng loạt, bạn có thể nhận thông tin về số lượng tin nhắn được gửi thành công và thậm chí nhận danh sách các tin này. The SucceededSending sự kiện dành cho mục đích này.

Mẫu mã:

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

Gửi Email với MultiConnection

Cái UseMultiConnection thuộc tính có thể được sử dụng để tạo nhiều kết nối cho các hoạt động nặng. Bạn cũng có thể đặt số lượng kết nối sẽ được sử dụng trong chế độ đa kết nối bằng cách sử dụng SmtpClient.ConnectionsQuantity. Đoạn mã dưới đây minh họa việc sử dụng chế độ đa kết nối để gửi nhiều tin nhắn.

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

Xin lưu ý rằng việc sử dụng chế độ đa kết nối không đảm bảo tăng hiệu suất.

Gửi Tin nhắn dưới dạng TNEF

Email TNEF có định dạng đặc biệt có thể bị mất nếu gửi bằng API tiêu chuẩn. The SmtpClient lớp UseTnef thuộc tính có thể được đặt để gửi email dưới dạng TNEF. Đoạn mã sau cho bạn thấy cách gửi tin nhắn dưới dạng 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);

Gửi Yêu cầu Họp

Aspose.Email cho phép các nhà phát triển thêm chức năng lịch vào email của bạn.

Gửi Yêu cầu qua Email

Để gửi lời mời họp qua email, làm theo các bước sau:

Tạo một đối tượng của MailMessage lớp.
Chỉ định địa chỉ người gửi và người nhận bằng một instance của MailMessage lớp.
Khởi tạo một instance của Appointment lớp và truyền các giá trị của nó.
Chỉ định tóm tắt và mô tả trong Calendar thể hiện.
Thêm Calendar đến MailMessage instance và truyền vào Appointment thể hiện.

|Yêu cầu họp iCalendar được gửi qua email| | :- | || Đoạn mã sau cho bạn thấy cách gửi yêu cầu qua 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());
}

Chuyển tiếp Tin nhắn

Chuyển tiếp Tin nhắn với SMTP Client

Chuyển tiếp một email là thực hành phổ biến. Một email đã nhận có thể được chuyển tiếp tới các người nhận cụ thể. The Chuyển tiếp phương pháp này có thể được sử dụng để chuyển tiếp một email đã nhận hoặc đã lưu tới những người nhận mong muốn. Đoạn mã dưới đây cho bạn thấy cách chuyển tiếp email bằng SMTP Client.

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

Chuyển tiếp Tin nhắn mà không cần MailMessage

API cũng hỗ trợ chuyển tiếp các tin nhắn EML mà không cần tải vào MailMessage. Điều này hữu ích trong trường hợp tài nguyên hệ thống, như bộ nhớ, bị giới hạn.


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

Chuyển tiếp Tin nhắn Bất đồng bộ mà không cần 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

Cách Hợp Nhất Email

Mail merge giúp bạn tạo và gửi một loạt các tin nhắn email tương tự. Nội dung chính của các email là giống nhau, nhưng nội dung có thể được cá nhân hoá. Thông thường, thông tin liên hệ của người nhận (tên, họ, công ty, …) được dùng để cá nhân hoá email.

|Minh họa cách mail merge hoạt động:| | :- | || Aspose.Email cho phép các nhà phát triển thiết lập mail merge bao gồm dữ liệu từ nhiều nguồn dữ liệu khác nhau.

Để thực hiện mail merge với Aspose.Email, thực hiện các bước sau:

Tạo một hàm với chữ ký tên
Tạo một đối tượng của MailMessage lớp.
Chỉ định người gửi, người nhận, tiêu đề và nội dung.
Tạo chữ ký cho phần cuối của email.
Tạo một đối tượng của TemplateEngine lớp và truyền cho nó MailMessage thể hiện.
Lấy chữ ký trong TemplateEngine thể hiện.
Tạo một thể hiện của lớp DataTable.
Thêm các cột Receipt, FirstName và LastName làm nguồn dữ liệu trong lớp DataTable.
Tạo một thể hiện của lớp DataRow.
Chỉ định địa chỉ nhận, họ và tên trong đối tượng DataRow.
Tạo một đối tượng của MailMessageCollection lớp
Chỉ định TemplateEngine và các thể hiện DataTable trong MailMessageCollection thể hiện.
Tạo một đối tượng của SmtpClient lớp và chỉ định server, port, tên người dùng và mật khẩu.
Gửi email bằng cách sử dụng SmtpClient lớp Gửi phương thức.

Trong mẫu dưới đây, #FirstName# chỉ một cột DataTable, giá trị của nó được người dùng thiết lập. Đoạn mã dưới đây cho bạn thấy cách thực hiện 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();
}

Cách Thực hiện Mail Merge theo Hàng

Người dùng có thể hợp nhất một hàng dữ liệu riêng lẻ cũng như nhận được một kết quả hoàn chỉnh và đã chuẩn bị MailMessage đối tượng. The TemplateEngine.Merge phương thức có thể được sử dụng để thực hiện mail merge theo hàng.

// 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: Kích hoạt Ghi Lại Hoạt Động SMTP trong .NET bằng cách sử dụng appsettings.json

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

Ghi lại hoạt động được sử dụng để gỡ lỗi, cũng như để thu thập và phân tích thông tin làm việc về SMTP client.

Bật ghi nhật ký hoạt động

Sử dụng Tệp appsettings.json để Kích hoạt Ghi Lại Hoạt Động

LƯU Ý: Tùy chọn này được ưu tiên cho các ứng dụng .NET Core.

Đăng nhập SmtpClient có thể được bật với các bước và mẫu mã sau:

Thêm tệp cấu hình appsettings.json vào dự án C#, nếu nó chưa được thêm trước đó.

Đảm bảo rằng tệp dự án chứa các dòng sau trong phần ItemGroup.

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

Sau đó, thêm nội dung sau vào tệp appsettings.json.

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

Hai thuộc tính được đề cập ở trên là:

SmtpDiagnosticLog - chỉ định đường dẫn tương đối hoặc tuyệt đối tới tệp log.
SmtpDiagnosticLog_UseDate - chỉ định có nên thêm biểu diễn chuỗi của ngày hiện tại vào tên tệp log hay không.

Kích hoạt Ghi Lại Hoạt Động trong Mã Chương Trình

Bạn cũng có thể bật ghi nhật ký ngay trong mã.

LƯU Ý: ngay cả khi bạn đã bật ghi nhật ký bằng tệp cấu hình, tùy chọn này sẽ được áp dụng.

Đăng nhập SmtpClient có thể được bật với các bước và mẫu mã sau:

Tạo một SmtpClient.
Đặt đường dẫn tới tệp nhật ký bằng cách sử dụng LogFileName thuộc tính.
Đặt UseDateInLogFileName thuộc tính nếu cần thiết.

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

Sử dụng Tệp App.config để Kích hoạt Ghi Lại Hoạt Động

Hoạt động của SMTP client có thể được ghi lại bằng cách sửa đổi configSections trong tệp cấu hình. Ghi log chẩn đoán có thể được thực hiện với các bước sau:

Thêm một nhóm phần có tên "applicationSettings".
Thêm một phần có tên "Aspose.Email.Properties.Settings".
Bao gồm cài đặt có tên SmtpDiagonosticLog, trong đó tên tệp được định nghĩa trong applicationSettings/Aspose.Email.Properties.Settings

Đây là một ứng dụng mẫu dựa trên form sử dụng SmtpClient để gửi một email. Toàn bộ hoạt động này được ghi lại bằng cách sửa đổi tệp App.config. Tạo một ứng dụng form với một nút duy nhất. Thêm đoạn mã sau cho sự kiện click của nút:

Thêm tham chiếu đến Aspose.Email.

Thêm tệp App.Config và sửa đổi nó sao cho nội dung tệp như sau

Đối với C# .NET, sử dụng tùy chọn sau

Đối với VB .NET, sử dụng tùy chọn sau

Chạy mã và sau đó kiểm tra thư mục debug. Tệp sau sẽ được tạo ra.