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

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

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

Kết Nối tới Máy Chủ POP3

Cái Pop3Client lớp cho phép các ứng dụng quản lý hộp thư email bằng giao thức Bưu Điện (Post Office Protocol), Phiên bản 3 (POP3). Lớp này là điểm vào chính cho các nhà phát triển muốn thêm quản lý POP3 vào các ứng dụng .NET của họ.

Để kết nối tới máy chủ POP3:

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

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

Kết Nối tới Máy Chủ SSL

Quá trình kết nối tới máy chủ POP3 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:

SecurityOptions
Cổng

Để kết nối tới máy chủ POP3 có SSL, hãy đặt SecurityOptions và các thuộc tính Port. Đoạn mã dưới đây cho thấy cách kết nối tới máy chủ POP3 có SSL bật.

Kết Nối tới Máy Chủ APOP

POP là viết tắt của Post Office Protocol. APOP là viết tắt của Authenticated Post Office Protocol. APOP là phiên bản mở rộng của cài đặt máy chủ POP3, mã hoá tên người dùng và mật khẩu của bạn và sử dụng cơ chế xác thực được thiết kế để bảo vệ mật khẩu tài khoản POP3 khi kiểm tra email. Xác thực APOP không yêu cầu mật khẩu tài khoản được gửi dưới dạng văn bản thuần tới máy chủ email POP3.

Kết Nối tới Máy Chủ qua Proxy

Địa chỉ proxy được sử dụng cho các trình khách email để truy cập hộp thư qua Internet. Aspose.Email hỗ trợ các phiên bản 4, 4a và 5 của giao thức proxy SOCKS.

Để lấy email qua máy chủ proxy:

Khởi tạo Proxy 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 Pop3Client 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 thuộc tính Proxy của một trình khách thành Proxy đối tượng được tạo ở trên.

Đoạn mã sau đây cho thấy cách lấy email qua máy chủ proxy.

Kết Nối tới Máy Chủ qua Proxy HTTP

Kết Nối với Xác Thực CRAM-MD5

Sử dụng xác thực CRAM-MD5, Aspose.Email cho .NET cho phép người dùng xác thực an toàn và truy cập các máy chủ email hỗ trợ phương thức xác thực này. Mẫu mã dưới đây cho thấy cách sử dụng cơ chế này trong dự án của bạn:

popClient.AllowedAuthentication = Pop3KnownAuthenticationType.CramMD5;

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

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

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

Mẫu mã dưới đây minh họa việc lấy các phần mở rộng của máy chủ bằng POP3Client cho máy chủ Gmail.

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

using (Pop3Client pop3Client = new Pop3Client("host", 995, "username", "password", SecurityOptions.Auto))
{
    pop3Client.Timeout = 60000; // 60 seconds

    // some code...
}

Sử dụng giao thức mật mã với client POP3

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

using (Pop3Client pop3Client = new Pop3Client("host", 995, "username", "password", SecurityOptions.Auto))
{
    pop3Client.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ệ.

Net: Xác thực thông tin đăng nhập máy chủ POP3 trong C#

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

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

Nó xác minh rằng thông tin đăng nhập email, như tên người dùng và mật khẩu, là hợp lệ và khách hàng 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 an toàn vào tài khoản email và thực hiện các thao tác khác nhau, chẳng hạn như nhận email.

using (Pop3Client client = new Pop3Client(server.Pop3Url, server.Pop3Port, "userName", "password", SecurityOptions.Auto))
{
    client.Timeout = 4000;
   
    if (client.ValidateCredentials())
    {
        //to do something
    }
}

Để thực hiện 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: Cách bật ghi nhật ký hoạt động POP3 trong .NET

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

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

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

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

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

Đăng nhập Pop3Client 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.

   {
     "Pop3DiagnosticLog": "Pop3.log",
     "Pop3DiagnosticLog_UseDate": true
   }

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

Pop3DiagnosticLog - chỉ định đường dẫn tương đối hoặc tuyệt đối tới tệp nhật ký.
Pop3DiagnosticLog_UseDate - chỉ định xem 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 nhật ký hay không.

Sử dụng mã chương trình để bật ghi nhật ký hoạt động

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 Pop3Client có thể được bật với các bước và mẫu mã sau:

Tạo một Pop3Client.
Đặ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 Pop3Client("your pop3 server", 995, "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.Pop3.log";

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

Bật ghi nhật ký hoạt động với tệp App.config

Pop3Client 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 Pop3Client để 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 form với một nút duy nhất. Thêm đoạn mã mẫu sau cho sự kiện click của 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 đó quan sát thư mục Log. Tệp sau sẽ được tạo.

Net: Truy xuất và Quản lý Tin nhắn từ Máy chủ Mail

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

Lấy Thông Tin Hộp Thư

Chúng ta có thể lấy thông tin về hộp thư như số lượng tin nhắn và kích thước hộp thư bằng cách sử dụng GetMailBoxSize và GetMailBoxInfo phương thức của Pop3Client lớp.

Cái GetMailBoxSize phương thức trả về kích thước của hộp thư tính bằng byte.
Cái GetMailBoxInfo phương thức trả về một đối tượng kiểu Pop3MailBoxInfo.

Cũng có thể lấy số lượng tin nhắn bằng cách sử dụng MessageCount thuộc tính và kích thước bằng cách sử dụng OccupiedSize thuộc tính của Pop3MailBoxInfo lớp. Đoạn mã mẫu sau cho thấy cách lấy thông tin về hộp thư. Nó cho thấy cách:

Tạo một Pop3Client.
Kết nối đến máy chủ POP3.
Lấy kích thước của hộp thư.
Lấy thông tin hộp thư.
Lấy số lượng tin nhắn trong hộp thư.
Lấy kích thước đã chiếm.

Lấy Số Lượng Email trong Hộp Thư

Đoạn mã sau cho bạn thấy cách đếm số tin nhắn email trong hộp thư.

Aspose.Email cho phép các nhà phát triển làm việc với email theo nhiều cách khác nhau. Ví dụ, họ có thể lấy thông tin tiêu đề trước khi quyết định có tải email xuống hay không. Hoặc họ có thể lấy email từ máy chủ và lưu chúng mà không cần phân tích (nhanh hơn) hoặc sau khi đã phân tích (chậm hơn).

Lấy Tiêu Đề Email

Tiêu đề email có thể cung cấp cho chúng ta thông tin về một tin nhắn email mà chúng ta có thể dùng để quyết định có nên lấy toàn bộ tin nhắn email hay không. Thông thường, thông tin tiêu đề bao gồm người gửi, chủ đề, ngày nhận, v.v. (Tiêu đề email được mô tả chi tiết trong Tùy chỉnh tiêu đề Email. Các ví dụ sau cho thấy cách lấy tiêu đề email từ máy chủ POP3 bằng số thứ tự của tin nhắn.

Lấy Tin Nhắn Email

Cái MailMessage lớp chứa nhiều thuộc tính và phương thức để thao tác nội dung email. Bằng cách sử dụng FetchMessage phương thức của Pop3Client lớp, bạn có thể nhận được một MailMessage được lấy trực tiếp từ máy chủ POP3. Đoạn mã dưới đây cho bạn thấy cách lấy một email đầy đủ từ máy chủ POP3.

Lấy Tóm Tắt Tin Nhắn với Id Duy Nhất

Khách hàng POP3 có thể lấy thông tin tóm tắt tin nhắn từ máy chủ bằng cách sử dụng id duy nhất của tin nhắn. Điều này cho phép truy cập nhanh vào thông tin ngắn gọn của tin nhắn mà không cần phải lấy toàn bộ tin nhắn từ máy chủ trước. Đoạn mã sau đây cho thấy cách lấy thông tin tóm tắt tin nhắn.

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

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

Lấy Tin Nhắn từ Máy Chủ và Lưu Lên Đĩa

Lưu tin nhắn vào đĩa mà không phân tích

Nếu bạn muốn tải xuống các tin nhắn email từ máy chủ POP3 mà không phân tích chúng, hãy sử dụng Pop3Client lớp SaveMessage hàm. Các SaveMessage hàm không phân tích tin nhắn email nên nhanh hơn so với FetchMessage hàm. Đoạn mã sau đây cho thấy cách lưu một tin nhắn bằng số thứ tự của nó. Trong trường hợp này, SaveMessage phương thức lưu tin nhắn ở định dạng EML nguyên gốc mà không phân tích.

Phân tích tin nhắn trước khi lưu

Đoạn mã sau sử dụng Pop3Client FetchMessage phương thức để lấy một tin nhắn từ máy chủ POP3 bằng số thứ tự của nó, sau đó lưu tin nhắn vào đĩa sử dụng tiêu đề làm tên tệp.

Lấy Tin Nhắn Nhóm

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

Net: Lọc email từ máy chủ thư

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

Lọc tin nhắn theo Người gửi, Người nhận hoặc Ngày

Cái Pop3Client lớp, được mô tả trong Kết nối tới Máy chủ POP3, 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 để chỉ định các điều kiện truy vấn, ví dụ: ngày, tiêu đề, người gửi, người nhận, v.v. Các MailQueryBuilder lớp được sử dụng để xây dựng biểu thức tìm kiếm. Đầu tiên, tất cả các điều kiện và ràng buộc được đặt và sau đó MailQuery được điền bằng truy vấn được phát triển bởi MailQueryBuilder. Thuộc tính MailQuery đối tượng lớp được sử dụng bởi Pop3Client để trích xuất thông tin đã lọc từ máy chủ. Bài viết này cho thấy cách lọc tin nhắn email từ hộp thư. 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 trình bày cách lọc theo tiêu chí khác và cách xây dựng các truy vấn phức tạp hơn. Nó cũng cho thấy việc áp dụng bộ lọc Ngày và Giờ để truy xuất các email cụ thể từ hộp thư. Ngoài ra, còn chỉ ra cách áp dụng lọc phân biệt chữ hoa chữ thường.

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

Để lọc tin nhắn từ hộp thư:

Kết nối đến máy chủ POP3.
Tạo một thể hiện của MailQuery và đặt các thuộc tính mong muốn.
Gọi Pop3Client.ListMessages(MailQuery query) phương thức và truyền vào MailQuery trong các tham số để chỉ lấy 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ư POP3 và lấy các tin nhắn đã đến hôm nay và có từ "newsletter" trong tiêu đề.

Truy xuất tin nhắn theo tiêu chí cụ thể

Các mẫu mã ở trên hiển thị cách bạn có thể lọc tin nhắn dựa trên tiêu đề email và ngày. Chúng ta có thể sử dụng các thuộc tính khác để đặt các điều kiện hỗ trợ khác nữa. 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 cho thấy cách lọc email theo các tiêu chí khác:

Tìm email được gửi hôm nay.
Tìm email nhận được trong một khoảng thời gian.
Tìm email từ người gửi cụ thể.
Tìm email được gửi từ miền cụ thể.
Tìm email được gửi tới người nhận cụ thể.

Ngày hôm nay

Đoạn mã sau cho bạn thấy cách tìm email được gửi hôm nay.

Khoảng ngày

Đoạn mã sau cho bạn thấy cách tìm email nhận được trong một khoảng thời gian.

Người gửi cụ thể

Đoạn mã sau cho bạn thấy cách tìm email từ người gửi cụ thể.

Miền cụ thể

Đoạn mã sau cho bạn thấy cách tìm email được gửi từ một miền cụ thể.

Người nhận cụ thể

Đoạn mã sau cho bạn thấy cách tìm email được gửi đến người nhận cụ thể.

Xây dựng truy vấn phức tạp

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 làm tham số. Nó nhận các tin nhắn khớp với bất kỳ một trong hai điều kiện đã chỉ định. Đoạn mã dưới đây cho thấy cách lọc tin nhắn có “test” trong tiêu đề hoặc "noreply@host.com" là người gửi. Đoạn mã dưới đây cho bạn cách kết hợp các truy vấn bằng OR.

Bộ lọc phân biệt chữ hoa chữ thường

API cũng cung cấp khả năng lọc email từ hộp thư dựa trên tiêu chí phân biệt chữ hoa chữ thường. Các phương thức sau cung cấp khả năng tìm kiếm email bằng cách chỉ định cờ phân biệt chữ hoa chữ thường.

Method Aspose.Email.StringComparisonField.Contains(string value, bool ignoreCase)
Method Aspose.Email.StringComparisonField.Equals(string value, bool ignoreCase)
Method Aspose.Email.StringComparisonField.NotContains(string value, bool ignoreCase)
Method Aspose.Email.StringComparisonField.NotEquals(string value, bool ignoreCase)

Net: Xóa Email khỏi Máy Chủ POP3

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

Xóa Email khỏi Máy Chủ

Cái Pop3Client lớp sử dụng giao thức POP3 để sao chép các tin nhắn email từ hộp thư vào máy tính của bạn. Khi email đã được lấy về, bạn không cần kết nối internet trong khi đọc vì có thể đọc email đã lấy trên PC. Nếu bạn không cần hoặc không muốn giữ một bản sao của một số tin nhắn trên máy chủ POP3, bạn có thể xóa chúng. Phần này cho thấy cách xóa email bằng cách sử dụng Pop3Client lớp.

Xóa Email theo Chỉ mục

Đoạn mã dưới đây xóa tất cả các tin nhắn email của một hộp thư một cách tuần tự, dựa trên chỉ số của chúng. Chỉ số không bao giờ nên <=0 trong Pop3Client.DeleteMessage.

Xóa Tất cả Email

Chúng ta cũng có thể gọi Pop3Client.DeleteMessages để xóa tất cả các tin nhắn. Đoạn mã dưới đây cho bạn thấy cách xóa tất cả email.

// Delete all the messages
client.DeleteMessages();

Nếu kết nối tới máy chủ POP3 bị gián đoạn ngay sau các thao tác xóa, bạn không thể gọi Hủy Xóa để thực hiện những điều mong muốn.

Hủy Xóa Email

Pop3Client.UndeleteMessages có thể được sử dụng để hủy việc xóa các tin nhắn email. Đoạn mã dưới đây cho bạn thấy cách hủy việc xóa.

// Cancel deletes
client.UndeleteMessages();

Net: Xử lý Email Bất đồng bộ với POP3 Client

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

Các hoạt động bất đồng bộ với Pop3Client

Làm việc với tin nhắn cũng có thể thực hiện bất đồng bộ bằng cách sử dụng Aspose.Email Pop3Client. Bài viết này trình bày cách lấy tin nhắn từ hộp thư một cách bất đồng bộ. Nó cũng chỉ ra 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 hộp thư được khởi động bằng mô hình bất đồng bộ dựa trên tác 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 lấy danh sách tin nhắn bất đồng bộ như trong đoạn mã mẫu dưới đây.

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 nhận thông tin về hộp thư bằng phương thức dựa trên mẫu bất đồng bộ (task-based asynchronous pattern) có tên GetMailboxInfoAsync 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

using (Pop3Client client = new Pop3Client(host, 995, senderEmail, password, SecurityOptions.Auto))
{
    CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
    AutoResetEvent autoResetEvent = new AutoResetEvent(false);
    Exception exception = null;

    ThreadPool.QueueUserWorkItem(delegate
    {
        try
        {
            // start receiving mailbox information
            var task = client.GetMailboxInfoAsync(cancellationTokenSource.Token);
            Pop3MailboxInfo mailboxInfo = task.GetAwaiter().GetResult();
            Console.WriteLine("Message count: " + mailboxInfo.MessageCount);
        }
        catch (Exception e)
        {
            exception = e;
        }
        finally
        {
            autoResetEvent.Set();
        }
    });

    Thread.Sleep(2000);

    // stop receiving mailbox information
    cancellationTokenSource.Cancel();
    autoResetEvent.WaitOne();

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