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

Net: Kết nối tới máy chủ IMAP

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

Liệt Kê Các Phần Mở Rộng Máy Chủ IMAP

Aspose.Email ImapClient cho phép bạn truy xuất 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 đó. 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 chuỗi. Đoạn mã sau đây cho bạn thấy cách truy xuất các phần mở rộng.

Kết Nối IMAP Tiêu Chuẩn

Cái ImapClient lớp cho phép các ứng dụng quản lý hộp thư IMAP bằng giao thức IMAP. ImapClient lớp được sử dụng để kết nối tới máy chủ thư IMAP và quản lý email trong các thư mục email IMAP. Để kết nối tới máy chủ IMAP

Tạo một đối tượng của ImapClient lớp.
Xác định tên máy, tên người dùng và mật khẩu trong ImapClient constructor.

Lưu ý, các hạn chế về mật khẩu phải đáp ứng yêu cầu của máy chủ. Ứng dụng khách email không thêm các hạn chế mật khẩu.

Khi ImapClient phiên bản được khởi tạo, lần gọi tiếp theo tới bất kỳ thao tác nào sử dụng phiên bản này sẽ kết nối tới máy chủ. Đoạn mã sau cho bạn thấy cách kết nối tới máy chủ IMAP bằng các bước trên.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

Kết Nối IMAP Có SSL

Kết nối với máy chủ IMAP mô tả cách kết nối tới máy chủ IMAP trong bốn bước đơn giản:

Tạo một đối tượng của ImapClient lớp.
Xác định tên máy, tên người dùng và mật khẩu.
Xác định cổng.
Chỉ định các tùy chọn bảo mật.

Quá trình kết nối tới máy chủ IMAP hỗ trợ SSL tương tự nhưng yêu cầu bạn đặt một vài thuộc tính khác:

Thiết lập SecurityOptions đến SSLImplicit.

Đoạn mã sau cho thấy cách

Đặt tên người dùng, mật khẩu và cổng.
Đặt tùy chọn bảo mật.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create an instance of the ImapClient class
ImapClient client = new ImapClient("imap.domain.com", 993, "user@domain.com", "pwd");
            
// Set the security mode to implicit
client.SecurityOptions = SecurityOptions.SSLImplicit;

Cấu Hình Kết Nối Proxy

Kết nối tới Máy chủ qua Proxy

Các máy chủ proxy thường được dùng để giao tiếp với bên ngoài. Trong các trường hợp như vậy, các khách hàng email 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. Bài viết này cung cấp một mẫu thực tế về cách truy cập hộp thư bằng máy chủ proxy. Để truy cập hộp thư qua máy chủ proxy:

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

Đoạn mã sau cho bạn thấy cách truy xuất hộp thư qua máy chủ proxy.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Connect and log in to IMAP and set SecurityOptions
ImapClient client = new ImapClient("imap.domain.com", "username", "password");
client.SecurityOptions = SecurityOptions.Auto;
            
string proxyAddress = "192.168.203.142"; // proxy address
int proxyPort = 1080; // proxy port
SocksProxy proxy = new SocksProxy(proxyAddress, proxyPort, SocksVersion.SocksV5);

// Set the proxy
client.Proxy = proxy;
           
try
{
    client.SelectFolder("Inbox");
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}

Kết nối tới máy chủ qua HTTP Proxy

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
HttpProxy proxy = new HttpProxy("18.222.124.59", 8080);
using (ImapClient client = new ImapClient("imap.domain.com", "username", "password"))
{
    client.Proxy = proxy;
    client.SelectFolder("Inbox");
}

Kết Nối Chế Độ Chỉ Đọc

Cái ImapClient lớp cung cấp một ReadOnly thuộc tính khi được đặt thành true, chỉ ra rằng không nên thay đổi trạng thái cố định của hộp thư. Mẫu mã sau minh họa việc sử dụng ImapClient.ReadOnly thuộc tính. Nó lấy số lượng tin nhắn chưa đọc, sau đó lấy một tin nhắn và lại lấy số lượng tin nhắn chưa đọc trong chế độ chỉ đọc. Số lượng tin nhắn chưa đọc vẫn giữ nguyên cho thấy trạng thái cố định của hộp thư không bị thay đổi.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
ImapClient imapClient = new ImapClient();
imapClient.Host = "<HOST>";
imapClient.Port = 993;
imapClient.Username = "<USERNAME>";
imapClient.Password = "<PASSWORD>";
imapClient.SupportedEncryption = EncryptionProtocols.Tls;
imapClient.SecurityOptions = SecurityOptions.SSLImplicit;

ImapQueryBuilder imapQueryBuilder = new ImapQueryBuilder();
imapQueryBuilder.HasNoFlags(ImapMessageFlags.IsRead); /* get unread messages. */
MailQuery query = imapQueryBuilder.GetQuery();

imapClient.ReadOnly = true;
imapClient.SelectFolder("Inbox");
ImapMessageInfoCollection messageInfoCol = imapClient.ListMessages(query);
Console.WriteLine("Initial Unread Count: " + messageInfoCol.Count());
if (messageInfoCol.Count() > 0)
{
    imapClient.FetchMessage(messageInfoCol[0].SequenceNumber);

    messageInfoCol = imapClient.ListMessages(query);
    // This count will be equal to the initial count
    Console.WriteLine("Updated Unread Count: " + messageInfoCol.Count());
}
else
{
    Console.WriteLine("No unread messages found");
}

Cài Đặt Xác Thực CRAM-MD5

Để xác thực an toàn và truy cập máy chủ email, Aspose.Email cho .NET cung cấp phương pháp xác thực CRAM-MD5. Đoạn mã sau sẽ cho bạn thấy cách nó hoạt động với ImapClient:

imapClient.AllowedAuthentication = ImapKnownAuthenticationType.CramMD5;

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

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 bạn.

Cấu Hình Thời Gian Chờ Thao Tác

using (ImapClient imapClient = new ImapClient("host", 993, "username", "password", SecurityOptions.SSLImplicit))
{
    imapClient.Timeout = 60000; // 60 seconds

    // some code...
}

Hạn Chế Thời Gian Chờ Lời Chào

Client IMAP có thể sử dụng chế độ tự động để thiết lập kết nối. Trong chế độ này, client IMAP sẽ thử tất cả các tham số kết nối khả dụng cho đến khi kết nối thành công. Máy chủ IMAP trong trường hợp kết nối đúng sẽ gửi một chuỗi chào tới client. Các máy chủ có thể sử dụng khởi tạo kết nối SSL/TLS ngầm định hoặc rõ ràng (START TLS). Nếu chế độ kết nối không khớp (ví dụ, máy chủ chờ kết nối SSL ngầm định nhưng client 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 và người dùng sẽ phải chờ lâu cho tới khi hết thời gian chờ, và client sẽ chuyển sang tùy chọn kết nối tiếp theo. Để tránh vấn đề này, thuộc tính GreetingTimeout đã được giới thiệu. Thuộc tính này cho phép bạn đặt thời gian chờ cho chuỗi chào, và giảm thời gian thiết lập kết nối tự động.

using (ImapClient client = new ImapClient("localhost", 993, "username", "password"))
{
    client.GreetingTimeout = 4000;
    client.SelectFolder(ImapFolderInfo.InBox);
}

Sử Dụng Giao Thức Mã Hoá với IMAP

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 ImapClient đối tượng lớp.

using (ImapClient imapClient = new ImapClient("host", 993, "username", "password", SecurityOptions.SSLImplicit))
{
    imapClient.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ệ.

Sử Dụng Lệnh IMAP IDLE

API của Aspose.Email ImapClient cung cấp khả năng mở kết nối tới máy chủ và chờ đợi sự xuất hiện của một tin nhắn email. Điều này cho phép tránh việc liên tục truy vấn máy chủ để kiểm tra email mới. Đoạn mã sau minh họa cách sử dụng thư viện Aspose.Email để giám sát hộp thư đến IMAP cho các tin nhắn mới và tin nhắn đã bị xóa, sau đó thực hiện các hành động cụ thể dựa trên các sự kiện này:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Connect and log in to IMAP 
ImapClient client = new ImapClient("imap.domain.com", "username", "password");

ManualResetEvent manualResetEvent = new ManualResetEvent(false);
ImapMonitoringEventArgs eventArgs = null;
client.StartMonitoring(delegate(object sender, ImapMonitoringEventArgs e)
{
    eventArgs = e;
    manualResetEvent.Set();
});
Thread.Sleep(2000);
SmtpClient smtpClient = new SmtpClient("exchange.aspose.com", "username", "password");
smtpClient.Send(new MailMessage("from@aspose.com", "to@aspose.com", "EMAILNET-34875 - " + Guid.NewGuid(), "EMAILNET-34875 Support for IMAP idle command"));
manualResetEvent.WaitOne(10000);
manualResetEvent.Reset();
Console.WriteLine(eventArgs.NewMessages.Length);
Console.WriteLine(eventArgs.DeletedMessages.Length);
client.StopMonitoring("Inbox");
smtpClient.Send(new MailMessage("from@aspose.com", "to@aspose.com", "EMAILNET-34875 - " + Guid.NewGuid(), "EMAILNET-34875 Support for IMAP idle command"));
manualResetEvent.WaitOne(5000);

Mẫu mã sau cho thấy cách thiết lập giám sát bất đồng bộ cho các tin nhắn email mới:

var client = = new ImapClient("imap.domain.com", "username", "password");

//anySuccess is a flag to prevent infinite Client.ResumeMonitoring calls
var anySuccess = false;
await client.StartMonitoringAsync(OnNewMessagesCallback, OnErrorCallback);

void OnErrorCallback(object eventSender, ImapMonitoringErrorEventArgs errorEventArguments)
{
    //The exception can be handled here
    Logger.Debug.Write(
        $"An error occured while folder monitoring: {errorEventArguments.FolderName}",
        errorEventArguments.Error);
    //IMAP folder monitoring is stopped on any error. Here is an example
    //of resuming after that.
    if (!anySuccess) return;
    anySuccess = false;
    //Make sure you use ResumeMonitoring instead of StartMonitoring here
    //to prevent missing any emails between the error handling and resuming.
    client.ResumeMonitoring(OnNewMessagesCallback, OnErrorCallback,
        errorEventArguments.MonitoringState);
}

void OnNewMessagesCallback(object sender, ImapMonitoringEventArgs successEventArgs)
{
    anySuccess = true;
    //Use successEventArgs.NewMessages to handle new messages
    //Use successEventArgs.DeletedMessages to handle deleted messages
}

Hỗ trợ các Tiện ích mở rộng IMAP

API Aspose.Email cung cấp hỗ trợ cho các tiện ích mở rộng IMAP. Các tiện ích mở rộng IMAP sau hiện đang được API hỗ trợ. Những tiện ích mở rộng này không được tất cả máy chủ hỗ trợ.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
using (ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password"))
{
    // Set SecurityOptions
    client.SecurityOptions = SecurityOptions.Auto;
    Console.WriteLine(client.IdSupported.ToString());

    ImapIdentificationInfo serverIdentificationInfo1 = client.IntroduceClient();
    ImapIdentificationInfo serverIdentificationInfo2 = client.IntroduceClient(ImapIdentificationInfo.DefaultValue);

    // Display ImapIdentificationInfo properties
    Console.WriteLine(serverIdentificationInfo1.ToString(), serverIdentificationInfo2);
    Console.WriteLine(serverIdentificationInfo1.Name);
    Console.WriteLine(serverIdentificationInfo1.Vendor);
    Console.WriteLine(serverIdentificationInfo1.SupportUrl);
    Console.WriteLine(serverIdentificationInfo1.Version);
}

Lệnh Danh sách Mở rộng IMAP4

Đoạn mã dưới đây cho bạn thấy cách sử dụng lệnh danh sách mở rộng IMAP4.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
using (ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password"))
{
    ImapFolderInfoCollection folderInfoCol = client.ListFolders("*");
    Console.WriteLine("Extended List Supported: " + client.ExtendedListSupported);
    foreach (ImapFolderInfo folderInfo in folderInfoCol)
    {
        switch (folderInfo.Name)
        {
            case "[Gmail]/All Mail":
                Console.WriteLine("Has Children: " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Bin":
                Console.WriteLine("Bin has children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Drafts":
                Console.WriteLine("Drafts has children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Important":
                Console.WriteLine("Important has Children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Sent Mail":
                Console.WriteLine("Sent Mail has Children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Spam":
                Console.WriteLine("Spam has Children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Starred":
                Console.WriteLine("Starred has Children? " + folderInfo.HasChildren);
                break;
        }
    }
}

Net: Quản Lý Tin Nhắn trên Máy Chủ IMAP

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

Lấy và Liệt Kê Tin Nhắn

Cách Lấy Thông Tin Định Danh cho Tin Nhắn trong Hộp Thư

Khi lấy và xử lý các tin nhắn email, bạn có thể nhận thông tin định danh chi tiết, như số thứ tự và ID duy nhất, bằng cách sử dụng các tính năng sau do phiên bản mới nhất của Aspose.Email cho .NET cung cấp:

Aspose.Email.ImapMessageInfo lớp: Đại diện cho thông tin định danh về một tin nhắn trong hộp thư IMAP.

ImapMessageInfo.SequenceNumber thuộc tính: Lấy số thứ tự của tin nhắn.

ImapMessageInfo.UniqueId thuộc tính: Lấy định danh duy nhất của tin nhắn.

Aspose.Email.MailMessage.ItemId thuộc tính: Đại diện cho thông tin định danh bổ sung về tin nhắn trong hộp thư.

Đoạn mã sau minh họa cách lấy thông tin định danh cho các tin nhắn trong hộp thư IMAP:

Tạo một đối tượng của ImapClient lớp bằng cách cung cấp các tham số cần thiết như máy chủ IMAP, cổng, địa chỉ email, mật khẩu và tùy chọn bảo mật.
Sử dụng ListMessages phương thức để lấy danh sách tin nhắn từ thư mục "INBOX". Giới hạn danh sách tới năm tin nhắn đầu tiên bằng phương thức Take(5).
Trích xuất các số thứ tự của các tin nhắn đã liệt kê bằng cách sử dụng SequenceNumber thuộc tính của mỗi tin nhắn.
Sử dụng FetchMessages phương thức để lấy chi tiết đầy đủ của các tin nhắn từ máy chủ, sử dụng các số thứ tự đã thu được ở bước trước.
Duyệt qua các tin nhắn đã lấy và với mỗi tin nhắn, lấy và hiển thị thông tin sau:

Số thứ tự của tin nhắn.
Thuộc tính ItemId.SequenceNumber.
Tiêu đề của tin nhắn.

using (var client = new ImapClient(imapHost, port, emailAddress, password, securityOption))
{
    // List the first 5 messages from the inbox
    var msgs = client.ListMessages("INBOX").Take(5);
    
    // Get sequence numbers of the messages
    var seqIds = msgs.Select(t => t.SequenceNumber);
    
    // Fetch messages based on sequence numbers
    var msgsViaFetch = client.FetchMessages(seqIds);
    
    for (var i = 0; i < 5; i++)
    {
        var thisMsg = msgsViaFetch[i];
        Console.WriteLine($"Message ID: {seqIds.ElementAt(i)} SequenceNumber: {thisMsg.ItemId.SequenceNumber} Subject: {thisMsg.Subject}");
    }
}

Liệt Kê ID Tin Nhắn MIME Từ Máy Chủ

ImapMessageInfo cung cấp MIME MessageId để xác định tin nhắn mà không cần trích xuất toàn bộ tin nhắn. Đoạn mã sau cho bạn thấy cách liệt kê MIME messageId.

Liệt kê Tin nhắn từ Máy chủ

Aspose.Email cung cấp một phiên bản overload 2 thành phần của ListMessages() để lấy một số lượng tin nhắn xác định dựa trên truy vấn. Đoạn mã sau cho bạn thấy cách liệt kê Tin Nhắn.

Liệt kê Tin nhắn Đệ quy

Giao thức IMAP hỗ trợ việc liệt kê tin nhắn đệ quy từ một thư mục hộp thư. Điều này cũng giúp liệt kê tin nhắn từ các thư mục con. Đoạn mã sau cho bạn thấy cách liệt kê tin nhắn một cách đệ quy.

Liệt kê Tin nhắn với MultiConnection

ImapClient cung cấp một UseMultiConnection thuộc tính có thể được sử dụng để tạo nhiều kết nối cho các thao tác 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 ImapClient.ConnectionsQuantity. Đoạn mã sau minh họa việc sử dụng chế độ đa kết nối để liệt kê tin nhắn và so sánh hiệu năng của nó với chế độ kết nối đơn.

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.

Liệt kê Tin nhắn với Hỗ trợ Phân trang

Trong các trường hợp, khi máy chủ email chứa một số lượng lớn tin nhắn trong hộp thư, thường cần liệt kê hoặc truy xuất các tin nhắn với hỗ trợ phân trang. API của Aspose.Email ImapClient cho phép bạn lấy các tin nhắn từ máy chủ với hỗ trợ phân trang.

Liệt kê Tệp Đính Kèm Tin Nhắn

Để lấy thông tin về các tệp đính kèm như tên, kích thước mà không cần tải dữ liệu tệp đính kèm, hãy thử các API sau:

Aspose.Email.Clients.Imap.ImapAttachmentInfo - Đại diện cho thông tin tệp đính kèm.
Aspose.Email.Clients.Imap.ImapAttachmentInfoCollection - Đại diện cho một tập hợp của ImapAttachmentInfo lớp.
Aspose.Email.Clients.Imap.ListAttachments(int sequenceNumber) - Lấy thông tin cho mỗi tệp đính kèm trong một tin nhắn.

Đoạn mã mẫu với các bước dưới đây sẽ cho bạn thấy cách sử dụng các API:

Gọi ListMessages() phương thức trên đối tượng imapClient. Phương thức này sẽ trả về một ImapMessageInfoCollection chứa thông tin về các tin nhắn trong hộp thư.
Duyệt qua từng tin nhắn trong messageInfoCollection bằng vòng lặp foreach.
Gọi ListAttachments() phương thức trên đối tượng imapClient, truyền thuộc tính SequenceNumber của đối tượng message làm tham số. Phương thức này sẽ trả về một ImapAttachmentInfoCollection chứa thông tin về các tệp đính kèm trong tin nhắn.
Duyệt qua từng tệp đính kèm trong attachmentInfoCollection bằng vòng lặp foreach.
Trong vòng lặp bên trong, bạn có thể truy cập thông tin về mỗi tệp đính kèm bằng cách sử dụng các thuộc tính của đối tượng attachmentInfo.

var messageInfoCollection = imapClient.ListMessages();
    
foreach (var message in messageInfoCollection)
{
    var attachmentInfoCollection = imapClient.ListAttachments(message.SequenceNumber);

    foreach (var attachmentInfo in attachmentInfoCollection)
    {
        Console.WriteLine("Attachment: {0} (size: {1})", attachmentInfo.Name, attachmentInfo.Size);
    }
}

Lấy và Lưu Tin nhắn

Lấy Tin nhắn từ Máy chủ

Cái ImapClient lớp có thể lấy tin nhắn từ máy chủ IMAP và lưu chúng ở định dạng EML lên đĩa cục bộ. Các bước sau đây cần thực hiện để lưu tin nhắn lên đĩa:

Tạo một đối tượng của ImapClient lớp.
Xác định hostname, cổng, tên người dùng và mật khẩu trong ImapClient constructor.
Chọn thư mục bằng cách sử dụng SelectFolder() phương thức.
Gọi ListMessages phương thức để lấy ImapMessageInfoCollection đối tượng.
Lặp qua ImapMessageInfoCollection bộ sưu tập, gọi SaveMessage() phương thức và cung cấp đường dẫn đầu ra cùng tên tệp.

Đoạn mã sau đây cho bạn thấy cách lấy các tin nhắn email từ máy chủ và lưu chúng.

Lấy Tin Nhắn theo Thứ Tự Giảm Dần

Aspose.Email cung cấp ImapClient.ListMessagesByPage phương thức liệt kê tin nhắn có hỗ trợ phân trang. Một số overload của ImapClient.ListMessagesByPage chấp nhận PageSettings như một tham số. PageSettings cung cấp một AscendingSorting thuộc tính mà khi được đặt thành false, sẽ trả về email theo thứ tự giảm dần.

Mã ví dụ sau đây minh họa cách sử dụng AscendingSorting thuộc tính của PageSettings lớp để thay đổi thứ tự của email.

Lưu tin nhắn ở định dạng MSG

Để lưu email ở định dạng MSG, ImapClient.FetchMessage() phương thức cần được gọi. Nó trả về tin nhắn dưới dạng một thể hiện của MailMessage lớp. MailMessage.Save() phương thức sau đó có thể được gọi để lưu tin nhắn thành MSG. Đoạn mã sau đây cho bạn thấy cách lưu tin nhắn ở định dạng MSG.

Nhóm Các Tin Nhắn Đã Lấy

ImapClient cung cấp một FetchMessages phương thức nhận một iterable của Số thứ tự hoặc ID duy nhất và trả về một danh sách của MailMessage. Đoạn mã sau minh họa việc sử dụng FetchMessages phương thức để lấy tin nhắn bằng Số thứ tự và ID duy nhất.

Lấy Thư Mục và Đọc Tin Nhắn Đệ Quy

Trong bài viết này, phần lớn các ImapClient các tính năng được sử dụng để tạo một ứng dụng liệt kê tất cả các thư mục và thư mục con một cách đệ quy từ máy chủ IMAP. Nó cũng lưu các tin nhắn trong mỗi thư mục và thư mục con ở định dạng MSG trên ổ đĩa cục bộ. Trên đĩa, các thư mục và tin nhắn được tạo và lưu trong cùng cấu trúc phân cấp như trên máy chủ IMAP. Đoạn mã dưới đây cho bạn thấy cách lấy thông tin các tin nhắn và thư mục con một cách đệ quy.

Xử lý Thông tin Tin nhắn Đặc biệt

Truy xuất các Tham số Bổ sung dưới dạng Thông tin Tóm tắt

Lấy Thông tin Header List-Unsubscribe

Tiêu đề List-Unsubscribe chứa URL để hủy đăng ký các danh sách email như quảng cáo, bản tin, v.v. Để lấy tiêu đề List-Unsubscribe, sử dụng ListUnsubscribe thuộc tính của ImapMessageInfo lớp. Ví dụ sau đây cho thấy cách sử dụng ListUnsubscribe thuộc tính để lấy tiêu đề List-Unsubscribe.

Net: Lọc Tin Nhắn từ Máy Chủ IMAP trong C#

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

Lọc Tin Nhắn Cơ Bản

Cái ImapClient class cung cấp ListMessages() phương thức lấy tất cả các tin nhắn từ một hộp thư. Để chỉ lấy các tin nhắn phù hợp với một số điều kiện, sử dụng phiên bản quá tải của ListMessages() phương thức nhận MailQuery được truyền làm đối số. Các MailQuery lớp cung cấp nhiều thuộc tính để xác định các điều kiện, chẳng hạn như ngày, tiêu đề, người gửi, người nhận v.v. Ví dụ đầu tiên minh họa cách lọc tin nhắn dựa trên ngày và tiêu đề. Chúng tôi cũng cho thấy cách lọc theo các tiêu chí khác và cách xây dựng các truy vấn phức tạp hơn. API cũng cung cấp khả năng áp dụng tiêu chí tìm kiếm phân biệt hoa thường để khớp chính xác tiêu chí lọc. API cũng cho phép chỉ định mã hoá chuỗi tìm kiếm để lọc tin nhắn từ hộp thư.

Lọc tin nhắn từ hộp thư

Kết nối và đăng nhập vào máy chủ IMAP
Tạo một đối tượng của MailQuery và đặt các thuộc tính
Gọi ImapClient.ListMessages(MailQuery query) phương thức và truyền vào MailQuery với các tham số để chỉ nhận các tin nhắn đã lọc.

Đoạn mã sau cho bạn thấy cách kết nối tới hộp thư IMAP và nhận các tin nhắn đến hôm nay và có từ "newsletter" trong tiêu đề.

Lọc Tin Nhắn Theo Tiêu Chí Cụ Thể

Các mẫu mã ở trên lọc tin nhắn dựa trên tiêu đề email và ngày. Chúng ta cũng có thể sử dụng các thuộc tính khác để đặt các điều kiện hỗ trợ khác. Dưới đây là một số ví dụ về việc thiết lập các điều kiện bằng cách sử dụng MailQuery. Các đoạn mã sau đây cho thấy cách lọc email trên:

Ngày hôm nay.
Một khoảng thời gian.
Từ người gửi cụ thể.
Từ miền cụ thể.
Từ người nhận cụ thể.

Ngày hôm nay

Đoạn mã sau cho bạn thấy cách lọc email dựa trên Ngày hôm nay.

Khoảng ngày

Đoạn mã sau cho bạn thấy cách lọc email theo khoảng thời gian.

Người gửi cụ thể

Đoạn mã sau cho bạn thấy cách lọc email dựa trên người gửi cụ thể.

Miền cụ thể

Đoạn mã sau cho bạn thấy cách lọc email dựa trên miền cụ thể.

Người nhận cụ thể

Đoạn mã sau cho bạn thấy cách lọc email dựa trên người nhận cụ thể.

Xây Dựng Truy Vấn Nâng Cao

Nếu khác MailQueryBuilder các thuộc tính được đặt trong các câu lệnh riêng biệt, sau đó mọi điều kiện sẽ được khớp. Ví dụ, nếu chúng ta muốn lấy tin nhắn trong một khoảng thời gian và từ một máy chủ cụ thể, chúng ta cần viết ba câu lệnh.

Kết hợp Truy vấn với AND

Đoạn mã sau cho bạn thấy cách kết hợp các truy vấn bằng AND.

Kết hợp Truy vấn với OR

MailQueryBuilder cung cấp Or() phương thức nhận hai MailQuery các thể hiện như tham số. Nó nhận các tin nhắn phù hợp với bất kỳ một trong hai điều kiện được chỉ định. Đoạn mã dưới đây cho thấy cách lọc tin nhắn mà có “test” trong tiêu đề hoặc “noreply@host.com” là người gửi. Đoạn mã sau cho bạn thấy cách kết hợp các truy vấn bằng OR.

Lọc Dựa Trên InternalDate

Tin nhắn có thể được trích xuất từ máy chủ dựa trên InternalDate tuy nhiên đôi khi máy chủ không trả về tất cả tin nhắn như hiển thị trong hộp đến. Nguyên nhân có thể là múi giờ của máy chủ vì nó có thể không phải UTC cho mọi máy chủ như Gmail. Aspose gửi các lệnh như 008 SEARCH ON 4-May-2014 theo giao thức IMAP tuy nhiên kết quả có thể khác nhau do cài đặt múi giờ của máy chủ. Một thành viên mới đã được thêm vào ImapMessageInfo như InternalDate điều này hỗ trợ hơn trong việc lọc tin nhắn. Đoạn mã sau cho thấy cách sử dụng của InternalDate để lọc tin nhắn.

Lọc Phân Biệt Hoa Thường

Đoạn mã sau cho bạn thấy cách sử dụng lọc email phân biệt chữ hoa chữ thường.

Chỉ định Encoding cho Query Builder

API của ImapQueryBuilder bộ khởi tạo có thể được dùng để chỉ định Encoding cho chuỗi tìm kiếm. Điều này cũng có thể được đặt bằng cách sử dụng DefaultEncoding thuộc tính của MailQueryBuilder. Đoạn mã sau cho bạn thấy cách chỉ định mã hoá cho bộ xây dựng truy vấn.

Tùy Chọn Lọc Tùy Chỉnh

Lọc tin nhắn với Cờ Tùy chỉnh

Tìm Kiếm Tùy Chỉnh Để Lọc

Ví dụ, tiêu chuẩn RFC 3501 không cho phép tìm kiếm tin nhắn dựa trên việc có đính kèm trong tin nhắn. Nhưng Gmail cung cấp Các mở rộng IMAP cho phép thực hiện tìm kiếm như vậy. Đoạn mã tiếp theo cho thấy cách tạo một truy vấn tương ứng.

ImapQueryBuilder queryBuilder = new ImapQueryBuilder();
queryBuilder.CustomSearch("X-GM-RAW \"has:attachment\"");

MailQuery mailQuery = queryBuilder.GetQuery();
ImapMessageInfoCollection messageInfoCollection = imapClient.ListMessages(mailQuery);

Lọc tin nhắn với Hỗ trợ Phân trang

Cái ImapClient cung cấp khả năng tìm kiếm tin nhắn từ hộp thư và liệt kê chúng với hỗ trợ phân trang. Đoạn mã sau cho bạn thấy cách lọc tin nhắn với hỗ trợ phân trang.

Net: Quản lý Cờ Tin nhắn trên Máy chủ IMAP

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

Đặt/Thay đổi Cờ Tin nhắn

Bạn có thể thay đổi cờ tin nhắn bằng cách đặt các cờ mới với ChangeMessageFlags() phương thức. Phương thức này nhận hai tham số.

Số thứ tự của một tin nhắn hoặc ID duy nhất của nó.
MessageFlag.

Các cờ sau có thể được đặt:

Đoạn mã mẫu sau cho bạn thấy cách thay đổi cờ tin nhắn trên máy chủ IMAP với Aspose.Email.

Xóa cờ tin nhắn

Các cờ tin nhắn cũng có thể bị xóa bằng RemoveMessageFlags() phương thức. Cách sử dụng tương tự như của ChangeMessageFlags() phương thức. Nó nhận một số thứ tự hoặc ID tin nhắn duy nhất và MessageFlag. Đoạn mã mẫu sau cho bạn thấy cách xóa cờ tin nhắn.

Đặt Cờ Tùy chỉnh

Bạn cũng có thể đặt cờ tùy chỉnh cho một tin nhắn bằng cách sử dụng ImapClient của API. ImapClient AddMessageFlags cung cấp khả năng đặt cờ tùy chỉnh trên các tin nhắn.

Net: Quản lý Thư mục trên Máy chủ IMAP

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

Các thao tác Thư mục

Lấy Thông tin Thư mục

Lấy thông tin về các thư mục từ máy chủ IMAP rất dễ dàng với Aspose.Email. Gọi ListFolders() phương thức của ImapClient lớp. Nó trả về một đối tượng của ImapFolderInfoCollection kiểu. Duyệt qua tập hợp này và lấy thông tin về từng thư mục trong vòng lặp. Phương thức này được nạp chồng. Bạn có thể truyền tên thư mục làm tham số để lấy danh sách các thư mục con. Đoạn mã dưới đây cho bạn thấy cách lấy thông tin thư mục từ máy chủ IMAP bằng Aspose.Email sử dụng phương pháp được mô tả trong thông tin.

Xóa và Đổi tên Thư mục

Một thư mục trên máy chủ IMAP có thể được xóa hoặc đổi tên trong một dòng lệnh duy nhất với Aspose.Email:

Cái DeleteFolder() phương thức chấp nhận tên thư mục làm tham số.
Đối với RenameFolder() phương thức, bạn cần truyền tên thư mục hiện tại và tên thư mục mới. Đoạn mã sau đây cho bạn thấy cách xóa một thư mục khỏi máy chủ IMAP, và cách đổi tên một thư mục. Mỗi thao tác được thực hiện bằng một dòng lệnh.

Làm việc với các Thư mục Hộp thư Dùng Đặc biệt

Một số kho tin nhắn IMAP bao gồm các hộp thư dùng đặc biệt, chẳng hạn như các hộp lưu bản nháp hoặc tin đã gửi. Nhiều client email cho phép người dùng chỉ định nơi lưu bản nháp hoặc tin đã gửi, nhưng việc cấu hình chúng yêu cầu người dùng biết các hộp thư mà máy chủ đã dành cho các mục đích này. Aspose.Email có thể xác định các hộp thư dùng đặc biệt này bằng cách sử dụng ImapMailboxInfo lớp để làm cho việc làm việc với chúng dễ dàng hơn. Mẫu mã sau đây minh họa cách truy cập các hộp thư dùng đặc biệt này bằng cách sử dụng ImapMailboxInfo lớp.

Các thao tác Tin nhắn trong Thư mục

Thêm Tin nhắn Mới vào Thư mục

Bạn có thể thêm một tin nhắn mới vào thư mục bằng cách sử dụng MailMessage và ImapClient các lớp. Đầu tiên tạo một MailMessage đối tượng bằng cách cung cấp các giá trị subject, to và from. Sau đó đăng ký một thư mục và thêm tin nhắn vào đó. Đoạn mã dưới đây cho bạn thấy cách thêm một Tin nhắn mới vào một thư mục.

Thêm Nhiều Tin nhắn với MultiConnection

Bạn có thể thêm nhiều tin nhắn bằng cách sử dụng AppendMessages phương thức do ImapClient các lớp. AppendMessages phương thức chấp nhận một danh sách của MailMessage và thêm nó vào thư mục hiện tại nếu thư mục không được cung cấp làm tham số. ImapClient cũng hỗ trợ chế độ MultiConnection cho các thao tác tải nặng. Đoạn mã sau đây cho bạn thấy cách thêm nhiều tin nhắn bằng cách sử dụng chế độ MultiConnection.

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.

Di chuyển Tin nhắn giữa Các Thư mục

Aspose.Email cho .NET cho phép di chuyển tin nhắn từ một thư mục hộp thư này sang thư mục khác bằng cách sử dụng ImapClient API. The MoveMessage phương thức sử dụng ID duy nhất của tin nhắn và tên thư mục đích để di chuyển tin nhắn tới thư mục đích. Đoạn mã dưới đây cho bạn thấy cách di chuyển tin nhắn sang thư mục hộp thư khác.

Sao chép Tin nhắn giữa các Thư mục

API Aspose.Email cung cấp khả năng sao chép tin nhắn từ một thư mục hộp thư này sang thư mục khác. Nó cho phép sao chép một tin nhắn hoặc nhiều tin nhắn bằng cách sử dụng CopyMessage và CopyMessages phương thức. CopyMessages phương thức cung cấp khả năng sao chép nhiều tin nhắn từ thư mục nguồn của một hộp thư sang thư mục hộp thư đích. Đoạn mã sau đây cho bạn thấy cách sao chép tin nhắn sang một thư mục hộp thư khác.

Net: Các thao tác IMAP bất đồng bộ: Lấy, Quản lý & Gửi Email

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

Các thao tác bất đồng bộ với ImapClient

Làm việc với tin nhắn có thể được thực hiện bất đồng bộ bằng cách sử dụng Aspose.Email ImapClient. Bài viết này trình bày việc truy xuất tin nhắn từ hộp thư một cách bất đồng bộ. Bài viết này cũng chỉ cách liệt kê tin nhắn bằng cách cung cấp tiêu chí tìm kiếm sử dụng MailQuery. Sẽ được trình bày riêng cách ngắt một thao tác với các tin nhắn email được bắt đầu bằng mô hình bất đồng bộ dựa trên nhiệm vụ (TAP) phương thức.

Truy xuất Tin nhắn bất đồng bộ

Đoạn mã sau cho bạn thấy cách truy xuất tin nhắn một cách bất đồng bộ.

Liệt kê Tin nhắn Bất đồng bộ với MailQuery

Cái MailQuery lớp có thể được sử dụng để chỉ định tiêu chí tìm kiếm nhằm truy xuất danh sách tin nhắn xác định một cách bất đồng bộ như được hiển thị trong mẫu mã sau.

Gửi tin nhắn bất đồng bộ

Gửi email bất đồng bộ rất tiện lợi, vì quá trình này không chặn việc thực thi của chương trình hoặc luồng. Thay vì chờ email được gửi trước khi tiếp tục các tác vụ khác, chương trình có thể tiếp tục chạy trong khi email đang được gửi ở nền.

Các tính năng sau sẽ giúp bạn triển khai việc gửi bất đồng bộ vào dự án của mình:

IAsyncImapClient - Cho phép các ứng dụng truy cập và thao tác các tin nhắn bằng giao thức Internet Message Access Protocol (IMAP).
ImapClient.CreateAsync - Tạo một thể hiện mới của lớp Aspose.Email.Clients.Imap.ImapClient

Đoạn mã mẫu dưới đây minh họa cách liệt kê tin nhắn trong nền:

// 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/IMAP.AccessAsUser.All" };

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

// Establish the connection with the server
// Create an instance of the ImapClient asynchronously using the CreateAsync method
// Select the Inbox folder using SelectFolderAsync method to complete and fetch the list of email messages asynchronously using the ListMessagesAsync method.
static async Task ImapAsync()
{
    var tokenProvider = new TokenProvider(clientId, tenantId, redirectUri, scopes);
    var client = ImapClient.CreateAsync("outlook.office365.com", username, tokenProvider, 993).GetAwaiter().GetResult();
    await client.SelectFolderAsync(ImapFolderInfo.InBox);
    var messages = await client.ListMessagesAsync();
    Console.WriteLine("Messages :" + messages.Count);
}

// 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()
    {

    }
}

Quản lý các thao tác bất đồng bộ

Ngắt một phương thức TAP

Bắt đầu từ .NET Framework 4.5, bạn có thể sử dụng các phương thức bất đồng bộ được triển khai theo mô hình TAP. Đoạn mã dưới đây cho thấy cách thêm nhiều tin nhắn bằng phương pháp bất đồng bộ dựa trên nhiệm vụ có tên AppendMessagesAsync và sau đó ngắt quá trình này sau một thời gian.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

List<MailMessage> mailMessages = new List<MailMessage>();

// create mail messages
for (int i = 0; i < 100; i++)
    mailMessages.Add(new MailMessage(senderEmail, receiverEmail, $"Message #{i}", "Text"));

using (ImapClient client = new ImapClient(host, 993, senderEmail, password, SecurityOptions.SSLImplicit))
{
    CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
    AutoResetEvent autoResetEvent = new AutoResetEvent(false);
    Exception exception = null;

    ThreadPool.QueueUserWorkItem(delegate
    {
        try
        {
            // start uploading the messages
            var task = client.AppendMessagesAsync(mailMessages, cancellationTokenSource.Token);
            AppendMessagesResult appendMessagesResult = task.GetAwaiter().GetResult();
            Console.WriteLine("All messages have been appended.");
        }
        catch (Exception e)
        {
            exception = e;
        }
        finally
        {
            autoResetEvent.Set();
        }
    });

    Thread.Sleep(5000);

    // stop uploading the messages
    cancellationTokenSource.Cancel();
    autoResetEvent.WaitOne();

    foreach (MailMessage mailMessage in mailMessages)
        mailMessage.Dispose();

    if (exception is OperationCanceledException)
        Console.WriteLine("Operation has been interrupted: " + exception.Message);
}

Hủy các thao tác bất đồng bộ

Đôi khi bạn có thể gặp nhu cầu dừng các thao tác bất đồng bộ. Vì mục đích này, thư viện của chúng tôi cung cấp khả năng hủy các thao tác bất đồng bộ thông qua tham số CancellationToken. Khi gọi một phương thức bất đồng bộ hỗ trợ hủy, bạn có thể truyền một thể hiện CancellationToken làm tham số. CancellationToken được sử dụng để báo hiệu và kiểm soát việc hủy thao tác.

Để bật hủy, trước tiên bạn cần tạo một thể hiện CancellationTokenSource cung cấp CancellationToken. Sau đó, truyền CancellationToken vào phương thức bất đồng bộ, cho phép nó kiểm tra yêu cầu hủy trong quá trình thực thi.

Dưới đây là một ví dụ minh họa việc hủy bằng CancellationToken:

CancellationTokenSource tokenSource = new CancellationTokenSource();
AppendMessagesResult appendMessagesResult = null;
AutoResetEvent autoResetEvent = new AutoResetEvent(false);
ThreadPool.QueueUserWorkItem(delegate(object state)
    {
        try
        {
            appendMessagesResult = imapClient.AppendMessagesAsync(mmList, tokenSource.Token).GetAwaiter().GetResult();
        }
        catch (Exception ex)
        {

        }
        finally
        {
            autoResetEvent.Set();
        }
    });

tokenSource.Cancel();
autoResetEvent.WaitOne();

Net: Cách Bật Ghi Nhận Hoạt Động IMAP

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

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

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 ImapClient 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.

   {
     "ImapDiagnosticLog": "imap.log",
     "ImapDiagnosticLog_UseDate": true
   }

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

ImapDiagnosticLog - chỉ định đường dẫn tương đối hoặc tuyệt đối tới tệp log.
ImapDiagnosticLog_UseDate - chỉ định có 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 ImapClient có thể được bật với các bước và mẫu mã sau:

Tạo một ImapClient.
Đặ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 ImapClient("your imap server", 993, "your username", "your password"))
{
    // Set security mode
    client.SecurityOptions = SecurityOptions.Auto;

    // Set the path to the log file using the LogFileName property.
    client.LogFileName = @"C:\Aspose.Email.IMAP.log";

    // Set the UseDateInLogFileName property if it is necessary.
    client.UseDateInLogFileName = false;
}

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

ImapClient hoạt động có thể được ghi lại bằng cách sửa đổi configSections trong tệp cấu hình. Dưới đây là các bước thực hiện ghi nhật ký chẩn đoán:

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

Đây là một ứng dụng form mẫu sử dụng ImapClient để xử lý thư. 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 dựa trên biểu mẫu với một nút duy nhất. Thêm mẫu mã sau cho sự kiện nhấp nút:

Thêm tham chiếu tới Aspose.Email.

Bây giờ 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 đó xem thư mục Log. Tệp sau sẽ được tạo ra.

Net: Xác thực Thông tin Đăng nhập Máy chủ Mail IMAP bằng API .NET

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

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

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

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

Đối với một thao tác bất đồng bộ, cũng có một phiên bản của phương thức ValidateCredentialsAsync.

Net: Hoạt động Sao lưu và Khôi phục IMAP

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

Sao lưu và Khôi phục Tiêu chuẩn

Aspose.Email cho .NET cung cấp khả năng sao lưu và khôi phục tin nhắn. Đối với việc này, API cung cấp các phương thức sau.

Bài viết này minh họa cách sao lưu và khôi phục tin nhắn bằng cách sử dụng ImapClient lớp.

Sao lưu Tin nhắn

Để sao lưu tin nhắn, sử dụng ImapClient.Backup phương thức như được minh họa trong đoạn mã dưới đây.

Khôi phục Tin nhắn

Để khôi phục tin nhắn, sử dụng ImapClient.Restore phương thức như được minh họa trong đoạn mã dưới đây.

Sao lưu và Khôi phục IMAP với MultiConnection

Khi làm việc với số lượng lớn tin nhắn, quá trình sao lưu/khôi phục có thể mất thời gian dài. Vì vậy, API cung cấp hỗ trợ đa kết nối trong quá trình sao lưu và khôi phục. Để bật chế độ MultiConnection, đặt ImapClient.UseMultiConnection thuộc tính để MultiConnectionMode.Enable. Các đoạn mã dưới đây minh họa hoạt động sao lưu và khôi phục với chế độ MultiConnection được bật.

Các đoạn mã dưới đây minh họa hoạt động sao lưu với chế độ MultiConnection được bật.

Các đoạn mã dưới đây minh họa hoạt động khôi phục với chế độ MultiConnection được bật.

Net: Cách Xóa Tin Nhắn từ Máy Chủ IMAP bằng .NET Core

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

Xóa tin nhắn

Cái ImapClient lớp có thể xóa tin nhắn từ máy chủ IMAP. ImapClient lớp DeleteMessage() hàm được sử dụng để xóa tin nhắn. Nó nhận số thứ tự tin nhắn hoặc ID duy nhất làm tham số. ImapClient cung cấp DeleteMessage và DeleteMessages phương thức để xóa tin nhắn từng cái một hoặc nhiều tin nhắn. Đoạn mã mẫu sau cho bạn thấy cách xóa một tin nhắn email có ID tin nhắn 1 từ máy chủ IMAP.

using var client = new ImapClient("host", "username", "password");
client.SecurityOptions = SecurityOptions.SSLImplicit;

// Append test message
client.SelectFolder(ImapFolderInfo.InBox);

var eml = new MailMessage("from@from.com", "to@to.com")
{
  Subject = "Message to delete",
  Body = "Hey! This Message will be deleted!"
};
var emlId = client.AppendMessage(eml);

// Delete appended message
client.DeleteMessage(emlId);
client.CommitDeletes();

Xóa nhiều tin nhắn

Có thể xóa nhiều email khỏi hộp thư bằng cách sử dụng ImapClient của API Aspose.Email. DeleteMessages phương thức cung cấp một số tùy chọn để xóa nhiều tin nhắn từ máy chủ bằng cách sử dụng ID duy nhất, số thứ tự hoặc ImapMessageInfoCollection phần tử. Đoạn mã mẫu sau cho bạn thấy cách xóa nhiều tin nhắn.

using var client = new ImapClient("host", "username", "password");
client.SelectFolder(ImapFolderInfo.InBox);
            
// Append test messages
var emlList = new List<MailMessage>();
{
  var eml = new MailMessage("from@from.com", "to@to.com")
  {
    Subject = $"Message to delete {i}",
    Body = "Hey! This Message will be deleted!"
  };
                
  emlList.Add(eml);
}

var appendMessagesResult = client.AppendMessages(emlList);
            
// Bulk Delete appended Messages
client.DeleteMessages(appendMessagesResult.Succeeded.Values, true);
client.CommitDeletes();