Documentation – Bài viết kỹ thuật

Net: Tại sao Aspose.Email

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

Net: So sánh Aspose.Email.Mail với các API của Microsoft

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

So sánh Aspose Email Mail với các API của MS

System.Web.Mail chỉ là một lớp bao quanh hai thư viện COM: CDONTS.NewMail (nằm trong cdonts.dll) và CDO.Message (nằm trong cdosys.dll). Bạn cũng cần chúng được cài đặt trên máy chủ của mình. Mặc định, cdonts.dll và cdosys.dll được cài đặt cùng với WindowsNT/2000/XP/2003.

Chi tiết SmtpMail

Nếu bạn theo dõi vào lớp System.Web.Mail.SmtpMail, bạn sẽ thấy một số hành vi lạ:

Nó chỉ hỗ trợ các hệ điều hành Win32NT, ví dụ, Windows 2000, Windows 2003, Windows XP.
Khi lớp SmtpMail gửi một tin nhắn email, nó kiểm tra phiên bản OS. Nếu phiên bản <= 4, đối tượng CDONTS.Newmail được sử dụng; đối với tất cả các hệ điều hành có phiên bản lớn hơn 4, đối tượng CDO.Message được sử dụng.

Những điểm đặc biệt này làm cho việc khắc phục sự cố trở nên khó khăn hơn nhiều, đặc biệt khi chuyển mã sang các hệ điều hành khác nhau. Ứng dụng có thể nhận được kết quả không mong muốn trên các OS khác nhau. Aspose.Email.Mail là một thành phần .NET được viết hoàn toàn bằng mã quản lý thuần túy trong C#. Nó không phụ thuộc vào bất kỳ thư viện COM nào, bao gồm CDONTS.NewMail hoặc CDO.Message. Với Aspose.Email.Mail, bạn tránh việc gọi bất kỳ mã không quản lý nào trong ứng dụng của mình, tăng độ tin cậy và giải phóng mình khỏi việc gỡ lỗi COM nhàm chán. Aspose.Email.Mail có nhiều tính năng và cung cấp nhiều dịch vụ hơn so với kiến trúc System.Web.Mail. System.Net.Mail là một triển khai mới của khách hàng giao thức SMTP trong .NET 2.0. Nó cũng là một triển khai mã quản lý thuần túy trong C#.

Ma trận So sánh

Tính năng	Aspose.Email.Mail	System.Web.Mail	System.Net.Mail
Các tính năng tương thích
Hỗ trợ .NET 2.0	X	X	X
Các tính năng chung
Phụ thuộc CDO/CDONTS		X
Mã quản lý thuần túy	X		X
Xác thực	X	X	X
Địa chỉ người gửi	X	X	X
Địa chỉ người nhận	X	X	X
Nội dung HTML	X	X	X
Nội dung văn bản	X	X	X
Bcc/Cc	X	X	X
Gửi tệp đính kèm	X	X	X
Hình ảnh liên kết	X		X
Mã hóa nội dung (Unicode/ASCII)	X	X	X
Mã hóa tiêu đề (Unicode/ASCII)	X		X
Mô hình lập trình đồng bộ	X		X
Mô hình lập trình bất đồng bộ	X		X
Các tính năng độc đáo
Tiêu đề thư tùy chỉnh	X
Tiêu đề mức quan trọng	X
Tiêu đề độ nhạy	X
Tiêu đề X-Mailer	X
Trả lời tới	X
Ngày gửi	X
Hợp nhất thư dựa trên mẫu	X
Hợp nhất thư từ DataSet	X
Hợp nhất thư từ DataTable	X
Hợp nhất thư từ DataReader	X
Gửi hàng loạt với đa luồng	X
Gửi lịch	X
Gửi yêu cầu họp	X
Tải từ định dạng Microsoft Msg	X
Tải từ định dạng Microsoft Mht	X
Lưu thành định dạng Microsoft Mht	X
Lưu thành định dạng Eml	X
Tải từ định dạng Eml	X
Tải từ tệp tuân thủ RFC 822	X
Các tính năng tương tác
Hoạt động với Aspose.Email.Pop3	X
Hoạt động với Aspose.Email.Imap	X
Hoạt động với Aspose.Email.Mime	X

Net: Sự khác biệt giữa POP3 và IMAP

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

Sự khác nhau giữa POP3 và IMAP

Dưới đây là giải thích về sự khác nhau chung giữa các giao thức email IMAP và POP3.

POP3 và IMAP

POP3 và IMAP đều là các giao thức email hoạt động với hầu hết các khách hàng email hiện đại. Sự khác biệt chính của chúng là cách quản lý và lưu trữ email.

POP3

Với tài khoản email POP3, bạn chỉ có một thư mục: thư mục Hộp đến. Khi mở hộp thư, thư mới được chuyển từ máy chủ và lưu trên máy tính của bạn. Nếu muốn đọc các email cũ, bạn phải vào máy tính nơi bạn lần cuối mở chúng. (Một số khách hàng email cho phép lưu email trên máy chủ để bạn có thể truy cập từ nhiều vị trí. Xem thêm bên dưới.)

Với loại tài khoản này, bạn không cần luôn đăng nhập vào Internet. Bạn có thể đăng nhập khi muốn nhận và gửi tin nhắn mới. Khi các tin nhắn mới đã được tải xuống máy tính, bạn có thể đăng xuất để đọc chúng. Tài khoản POP3 phù hợp khi bạn kết nối bằng modem tới DAS và bị tính phí kết nối, hoặc có máy tính cũ.

Tài khoản IMAP

Khi sử dụng giao thức này, tất cả email của bạn vẫn ở trên máy chủ trong nhiều thư mục, bao gồm cả những thư mục bạn tự tạo. Điều này cho phép bạn kết nối tới bất kỳ máy tính nào và xem toàn bộ email và thư mục email. Nói chung, IMAP rất phù hợp nếu bạn có kết nối Internet cố định hoặc kiểm tra email từ nhiều vị trí.

Giữ mail trên máy chủ vs. Xóa mail khỏi máy chủ

Nếu bạn sử dụng giao thức POP3 và đọc email từ nhiều máy tính, bạn muốn để email trên máy chủ để chúng luôn có sẵn. Nếu bạn không để email trên máy chủ, tất cả thư trong Hộp đến sẽ được tải xuống máy tính bạn đang sử dụng. Nếu bạn chỉ đọc email từ một nơi duy nhất, thì không cần để email trên máy chủ. Bạn sẽ thấy hướng dẫn cách thiết lập tùy chọn này khi thực hiện các bước cấu hình chương trình email của mình.

Tại sao nên chọn IMAP thay vì POP3 và để email trên máy chủ? Với POP3, chỉ có các tin nhắn email của bạn trên máy chủ, nhưng với IMAP, các thư mục email của bạn cũng nằm trên máy chủ.

Net: Truy cập Gmail qua SSL

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

SMTP

Bài viết này chỉ cách thực hiện kết nối tới máy chủ Gmail và gửi một email sử dụng giao thức SMTP trên SSL.

Kết nối tới máy chủ SMTP của Gmail

Đoạn mã dưới đây cho bạn thấy cách kết nối tới máy chủ SMTP hỗ trợ SSL.

Gửi một Tin Nhắn Email

Mã trên đã thiết lập đối tượng SMTPClient để kết nối tới máy chủ Gmail. Để gửi một tin nhắn bằng cùng đối tượng client, tạo một MailMessage đối tượng lớp và gửi tin nhắn bằng đối tượng khách hàng SMTP. Đoạn mã dưới đây cho bạn thấy cách thiết lập các thuộc tính của tin nhắn, ví dụ như chủ đề, người nhận và nội dung:

IMAP

Bài viết này chỉ cách thực hiện một số hoạt động trên máy chủ thư hỗ trợ SSL bằng giao thức IMAP:

Kết nối tới máy chủ thư.
Lấy tổng số tin nhắn trong hộp đến.
Lưu tin nhắn cục bộ.
Tạo một tin nhắn và thêm nó vào thư mục.

Kết nối tới Máy chủ Thư

Sử dụng Aspose.Email’s ImapClient đối tượng lớp để kết nối tới máy chủ thư. Địa chỉ, cổng, tên người dùng và mật khẩu của máy chủ là bắt buộc để thiết lập kết nối. Gmail sử dụng cổng 993 cho giao thức IMAP, đoạn mã dưới đây cho bạn thấy cách kết nối tới Gmail bằng cổng đó.

Chọn Thư mục và Lấy Tổng số Tin nhắn

Kiểm tra thư mục Inbox là nhiệm vụ thường xuyên nhất khi kiểm tra email. Sử dụng Aspose.Email, việc này có thể thực hiện chỉ bằng hai dòng mã đơn giản. Đoạn mã dưới đây cho bạn cách truy cập thư mục Inbox và lấy tổng số tin nhắn trong thư mục.

Lưu Tin nhắn vào Ổ Cứng Cục bộ

Sau khi một thư mục được chọn bằng phương thức SelectFolder, sử dụng hàm ListMessages để lấy danh sách tất cả các tin nhắn trong thư mục dưới dạng đối tượng ImapMessagesInfoCollection. Duyệt qua bộ sưu tập này và lưu các tin nhắn email vào ổ đĩa cục bộ của máy tính như sau:

Tạo Thư mục Mới

Giao thức IMAP cũng cho phép bạn tạo một thư mục mới trên máy chủ email. Điều này có thể thực hiện bằng một lời gọi hàm đơn giản.

Tạo một Tin nhắn Mới trong Thư mục

Thêm một tin nhắn mới vào thư mục bằng cách sử dụng MailMessage và ImapClient lớp. Các ví dụ dưới đây tạo một đối tượng MailMessage đầu tiên bằng cách cung cấp giá trị chủ đề, người nhận và người gửi. Sau đó, nó đăng ký vào một thư mục và thêm tin nhắn vào đó. Đoạn mã dưới đây cho bạn tạo một tin nhắn mới trong thư mục.

POP3

Bài viết này trình bày một số ví dụ sử dụng giao thức POP3 trên SSL. Để kết nối tới máy chủ được bảo vệ bằng SSL, chúng ta cần xác định cổng SSL và hai thuộc tính bổ sung. Phần còn lại của mã giống như khi kết nối tới máy chủ POP3 thông thường.

Các mẫu mã dưới đây cho thấy cách thực hiện:

Kết nối tới máy chủ SSL.
Kiểm tra trạng thái hộp thư
Lấy thông tin về tin nhắn
Lấy email.

Kết nối tới Máy chủ Thư

Kết nối tới máy chủ thư hỗ trợ SSL bằng cách sử dụng Pop3client lớp như mô tả dưới đây.

Kiểm tra trạng thái hộp thư

Đoạn mã sau cho bạn thấy cách kiểm tra số lượng tin nhắn được lưu trong hộp thư và kích thước của hộp thư. Sử dụng Pop3MailboxInfo lớp cho mục đích này.

Kiểm tra thông tin tin nhắn

Ví dụ này kiểm tra tất cả các tin nhắn trong hộp thư bằng cách sử dụng Pop3MessageInfoCollection lớp. Sử dụng Pop3Client.ListMessages() hàm để lấy Pop3MessageInfoCollection bộ sưu tập. Sau đó lặp qua bộ sưu tập để đọc thông tin tin nhắn: ID tin nhắn, chỉ mục, tiêu đề và kích thước

Lấy tin nhắn

Để lấy các tin nhắn từ hộp thư, sử dụng Pop3Client phương thức FetchMessage() của lớp để lấy tin nhắn vào một MailMessage đối tượng kiểu. Đoạn mã sau cho bạn thấy cách đếm số lượng email trong hộp thư và sau đó lặp qua chúng để lấy từng email.

Net: Giới thiệu các mẫu lặp lại

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

Bạn có thể xem một recurrence pattern như là một cách để mô tả một lịch trình cụ thể. Nó chứa đủ thông tin để xây dựng danh sách các lần xuất hiện (ngày và thời gian) theo lịch đã cho. Một mẫu lặp có thể chứa các quy tắc lặp mô tả các chu kỳ kết hợp để tạo thành mẫu tổng thể. Nói chung, mẫu lặp càng phức tạp, nó sẽ chứa càng nhiều quy tắc lặp. Mẫu lặp có thể bao gồm exceptions (không nên nhầm lẫn với các ngoại lệ đại diện cho lỗi xảy ra trong quá trình thực thi ứng dụng). Các ngoại lệ thêm vào hoặc loại bỏ các ngày xuất hiện so với mẫu gốc. Các ngoại lệ có thể được chỉ định dưới dạng các lần xuất hiện cụ thể hoặc tự chúng là một mẫu. Các ví dụ về mẫu lặp có ngoại lệ:

Mỗi thứ Sáu thứ hai, ngoại trừ từ tháng 6 đến tháng 8.
Ngày 1 của mỗi tháng, ngoại trừ tháng Giêng, khi nó sẽ rơi vào ngày 2.

Mẫu lặp thường là định kỳ, nhưng chúng không nhất thiết phải như vậy. Một mẫu lặp có thể được mô tả hoàn toàn chỉ như một tập hợp các ngày và thời gian xuất hiện được định sẵn. RFC iCalendar định nghĩa components, chẳng hạn như VEVENT hoặc VTODO, đại diện cho sự kiện hoặc nhiệm vụ. Các thành phần có thể có các thuộc tính như thời gian bắt đầu, mô tả, địa điểm, người tham dự và chu kỳ lặp lại. Do đó, một mẫu lặp thường tồn tại như một thuộc tính của một nhiệm vụ lặp lại hoặc một sự kiện. Các thuộc tính mẫu lặp được định nghĩa bởi iCalendar là:

DTSTART - ngày và thời gian bắt đầu của mẫu (cũng đại diện cho lần xuất hiện đầu tiên nếu không bị loại trừ một cách rõ ràng).
RRULE - chỉ định một quy tắc lặp lại cho một tập lặp lại.
RDATE - định nghĩa danh sách các ngày và thời gian để bao gồm trong tập lặp lại.
EXRULE - chỉ định một quy tắc lặp lại cho các ngoại lệ khỏi tập lặp lại.
EXDATE - định nghĩa danh sách các ngày và thời gian ngoại lệ khỏi tập lặp lại.

Chỉ cần DTSTART và phải có duy nhất một DTSTART. Tất cả các thuộc tính khác là tùy chọn và có thể được chỉ định nhiều lần. Aspose.iCalendar nhận một chuỗi ở định dạng iCalendar và đọc mẫu lặp vào một RecurrencePattern đối tượng. Chuỗi có thể là mô tả đầy đủ của một thành phần iCalendar (ví dụ, một VEVENT hoàn chỉnh) hoặc chỉ là một đoạn chứa mẫu lặp lại. Khi mẫu lặp đã được tải vào đối tượng RecurrencePattern, bạn có thể:

Xem xét và sửa đổi mẫu bằng chương trình thông qua các phương thức và thuộc tính do Aspose.iCalendar cung cấp
Tạo ngày/giờ xuất hiện trong phạm vi ngày xác định.
Lưu mẫu ở định dạng iCalendar.

Đoạn mã sau cho bạn thấy phần RRULE chứa quy tắc lặp lại.

Xem phần các mẫu lặp cho các minh họa về cách tạo mẫu lặp.

Về Mô Hình Đối Tượng Aspose.iCalendar

Không gian tên Aspose.iCalendar chứa tất cả các lớp được cung cấp bởi thành phần Aspose.iCalendar. RecurrencePattern và RecurrenceRule là các lớp trung tâm của Aspose.iCalendar, và cung cấp các triển khai cụ thể cho các phần tử RFC 2445 tương ứng.

Lớp RecurrencePattern đại diện cho toàn bộ mẫu lặp. Bạn có thể tạo một mẫu lặp mới từ đầu bằng cách sử dụng hàm tạo mặc định hoặc tải một mẫu hiện có ở định dạng iCalendar bằng phương thức tĩnh FromiCalendar. Lớp RecurrenceRule đại diện cho phần RRULE hoặc EXRULE của một mẫu lặp. RecurrenceRule cung cấp một số thuộc tính ánh xạ trực tiếp tới các đối tương trong tiêu chuẩn iCalendar. Ví dụ, ByMonth ánh xạ tới BYMONTH trong iCalendar và tương tự. Bằng cách kiểm tra hoặc đặt giá trị của các thuộc tính RecurrenceRule, bạn có thể phân tích hoặc sửa đổi một quy tắc lặp. Để biết thêm thông tin và mẫu mã, xem RecurrencePattern và RecurrenceRule trong Tài liệu API.

Mẫu Ví Dụ

Phần này bao gồm các chủ đề sau:

Ngày Cuối Cùng Của Tháng.
Ngày Làm Việc Cuối Cùng Mỗi Tháng.
Thứ Hai Cuối Cùng Của Năm.
Thứ Sáu của Tuần ISO 8601 Đầu Tiên trong Năm.
Thứ Sáu Đầu Năm.

Ngày Cuối Cùng Của Tháng

Các mẫu này mẫu lặp chỉ định ngày cuối cùng của tháng, mỗi tháng.

RRULE:FREQ=MONTHLY;BYMONTHDAY=-1

Tương tự, nếu bạn muốn một lần xuất hiện vào một ngày trước ngày cuối cùng của tháng, hãy sử dụng BYMONTHDAY=-2. Nếu bạn chỉ định BYMONTHDAY=31 thì theo tiêu chuẩn iCalendar, sẽ không có lần xuất hiện nào được tạo ra trong các tháng có ít hơn 31 ngày.

Ngày Làm Việc Cuối Cùng Mỗi Tháng

Các mẫu này mẫu lặp chỉ định ngày làm việc cuối cùng của tháng, mỗi tháng. Ngày làm việc được định nghĩa là những ngày bạn làm việc. Ở châu Âu, ví dụ, ngày làm việc thường là từ thứ Hai đến thứ Sáu.

RRULE:FREQ=MONTHLY;BYDAY=MO,TU,WE,TH,FR;BYSETPOS=-1

Quy tắc trên chỉ định tất cả các ngày làm việc của một tháng và chọn ngày cuối cùng trong số chúng. Kết quả là ngày làm việc cuối cùng trong tháng.

Thứ Hai Cuối Cùng Của Năm

Mẫu này mẫu lặp chỉ định một sự kiện xảy ra vào thứ Hai cuối cùng của năm.

RRULE:FREQ=YEARLY;BYDAY=-1MO

Thứ Sáu của Tuần ISO 8601 Đầu Tiên trong Năm

Mẫu này mẫu lặp chỉ định thứ Sáu của tuần đầu tiên trong năm. Theo đặc tả ISO 8601, tuần đầu tiên của năm là tuần có ít nhất bốn ngày. Khi một năm bắt đầu vào thứ Bảy, ví dụ, tuần 1 là tuần ngay sau đó, bắt đầu vào thứ Hai, ngày 3 tháng 1.

FREQ=YEARLY;BYWEEKNO=1;BYDAY=FR

Thứ Sáu Đầu Năm

Mẫu này mẫu lặp chỉ định một sự kiện xảy ra vào thứ Sáu đầu tiên của năm.

FREQ=YEARLY;BYDAY=1FR

Ví dụ, vào năm 1999, thứ Sáu thứ nhất của năm là 1999/01/01, trong khi thứ Sáu của tuần ISO 8601 thứ nhất là 1999/01/08.

Net: Chi tiết quan trọng về iCalendar RFC 2445

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

Về Mô Hình Đối Tượng Aspose.iCalendar

Cái Aspose.iCalendar không gian tên chứa tất cả các lớp được cung cấp bởi thành phần Aspose.iCalendar. RecurrencePattern và RecurrenceRule là các lớp trung tâm của Aspose.iCalendar và cung cấp các triển khai cụ thể cho các phần tử RFC 2445 tương ứng.

Chi tiết quan trọng iCalendar RFC 2445

Phần này bao gồm các chủ đề sau:

Định dạng Ngày và Giờ.
DATE.
DATE-TIME với Thời gian địa phương.
DATE-TIME với Thời gian UTC.
DATE-TIME với Thời gian địa phương và Múi giờ.
BYWEEKNO Cung cấp Tuân thủ ISO 8601

Định dạng Ngày và Giờ

Ngày, hoặc ngày kèm thời gian liên quan, có thể được sử dụng trong các phần tử DTSTART, UNTIL, EXDATE và RDATE khi chỉ định một mẫu lặp lại. iCalendar định nghĩa kiểu giá trị DATE để nhận diện các giá trị chứa ngày lịch và cũng định nghĩa kiểu DATE-TIME để nhận diện các giá trị chỉ định ngày lịch và thời gian trong ngày một cách chính xác. Các giá trị DATE-TIME có thể được chỉ định dưới ba dạng, với:

Thời gian địa phương.
Thời gian UTC.
Thời gian địa phương và múi giờ.

DATE

Theo tiêu chuẩn iCalendar, các giá trị DATE phải tuân theo định dạng yyyyMMdd. Ví dụ sau biểu thị ngày 14 tháng 7 năm 1997: 19970714

DATE-TIME với Thời gian địa phương

Ngày ở dạng thời gian địa phương chỉ đơn giản là một giá trị ngày‑giờ không chứa ký hiệu UTC và không tham chiếu đến múi giờ. Ví dụ, đoạn sau biểu thị ngày 18 tháng 1 năm 1998, lúc 23:00: DTSTART:19980118T230000. Các giá trị ngày‑giờ kiểu này được gọi là "floating" và không bị ràng buộc vào bất kỳ múi giờ nào cụ thể. Chúng được dùng để đại diện cho cùng một giá trị giờ, phút và giây bất kể múi giờ nào đang được áp dụng.

DATE-TIME với Thời gian UTC

Ngày có thời gian UTC, hoặc thời gian tuyệt đối, được xác định bằng ký tự hậu tố Z (chữ in hoa) được gắn vào giá trị thời gian. Ví dụ, đoạn sau đại diện cho ngày 19 tháng 1 năm 1998, lúc 07:00 UTC: DTSTART:19980119T070000Z. Lưu ý rằng Aspose.iCalendar bỏ qua định dạng hậu tố Z UTC và xử lý thời gian như là thời gian địa phương. Tiêu chuẩn RFC2445 quy định phần thời gian được chỉ định trong quy tắc UNTIL của một mẫu lặp phải ở định dạng UTC. Đây là một tuyên bố rất kỳ lạ, và thực tế, có các ví dụ trong tiêu chuẩn được tính toán sai. Aspose.iCalendar chấp nhận thời gian ở bất kỳ định dạng nào trong quy tắc UNTIL.

DATE-TIME với Thời gian địa phương và Múi giờ

Để tham chiếu múi giờ, DATE-TIME được sửa đổi bằng thuộc tính TZID. Ví dụ, đoạn sau đại diện cho 2 giờ sáng tại New York vào ngày 19 tháng 1 năm 1998: DTSTART;TZID=US-Eastern:19980119T020000. Lưu ý rằng Aspose.iCalendar hiện đang bỏ qua tham số TZID và xử lý thời gian như là thời gian địa phương.

BYWEEKNO Cung cấp Tuân thủ ISO 8601

Chỉ sử dụng BYWEEKNO khi tuân thủ với ISO 8601 được yêu cầu. Số tuần được định nghĩa theo ISO 8601 rất khác so với số tuần theo nghĩa thông thường. Theo ISO 8601, tuần số một của năm lịch là tuần đầu tiên của năm lịch có ít nhất bốn ngày. Quy tắc này làm cho thuật toán trở nên đặc thù cho các ứng dụng yêu cầu tuân thủ ISO 8601 và gần như không áp dụng cho các mục đích khác. ISO 8601 được một số ứng dụng ngân hàng và tài chính châu Âu hỗ trợ. Nó cũng được sử dụng trong truyền hình để đặt chỗ quảng cáo. Quy tắc BYWEEKNO xác định danh sách các số, ngăn cách bằng dấu phẩy, chỉ định các tuần của năm. Giá trị hợp lệ là 1 đến 53 và 1 đến 53. Điều này tương ứng với các tuần theo đánh số tuần được định nghĩa trong ISO 8601. BYWEEKNO chỉ hợp lệ cho các quy tắc YEARLY.

Net: Phân tích Tệp Tin Nhắn Microsoft Outlook

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

Với Aspose.Email, bạn có thể phân tích các tin Outlook chỉ bằng một vài dòng mã. Bài viết này chỉ cách thực hiện. Aspose.Email có các lớp để thực hiện nhiều tác vụ lập trình với tin Outlook. Ví dụ mã dưới đây cho thấy cách:

Tải một tin email.
Lấy tiêu đề email.
Lấy tên người gửi.
Lấy nội dung toàn bộ tin.
Kiểm tra xem có tệp đính kèm hay không.
Lấy tên tệp của các tệp đính kèm và lưu chúng.

Đoạn mã dưới đây cho bạn thấy cách phân tích các tệp tin tin nhắn Microsoft Outlook.

Net: Nhận thông báo cho các tin nhắn đã gửi thành công và thất bại

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

Khi bạn muốn nhận thông báo giao hàng cho cả tin nhắn đã gửi thành công và thất bại, bạn có thể sử dụng toán tử pipe (|) cho DeliveryNotificationOptions thuộc tính của MailMessage lớp. Đoạn mã mẫu sau cho bạn thấy cách nhận thông báo cho các tin nhắn đã gửi thành công và thất bại.

Net: Phát hiện Tin nhắn Email Mới trên Máy chủ POP3

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

Với tài khoản POP3, bạn có thể để lại các tin trên máy chủ khi tải xuống và đọc chúng. Việc để email trên máy chủ có nghĩa là chúng có sẵn cho các ứng dụng và cá nhân khác, ví dụ, người dùng truy cập email từ nhiều thiết bị. Hoặc bạn có thể muốn chỉ tải những tin đáp ứng tiêu chí đặc biệt, chẳng hạn như các tin có tiêu đề nhất định. Để quản lý email, bạn có thể;

Đọc tất cả các tin từ máy chủ thư POP3 bằng Aspose.Email.
Tải các tin vào cơ sở dữ liệu cục bộ của bạn.

Các tin không bị xóa mà vẫn ở trên máy chủ. Lần đầu chạy, quy trình này hoạt động tốt. Tất cả các tin cần thiết được tải xuống cơ sở dữ liệu. Nhưng lần thứ hai chạy, cùng các tin lại được tải vì chúng vẫn còn trên máy chủ email. Điều này gây ra bản ghi trùng lặp. Để giải quyết vấn đề này, sử dụng Pop3MessageInfo.UniqueID thuộc tính để kiểm tra xem một tin đã được tải xuống chưa. ID duy nhất của tin phải được lưu trong cơ sở dữ liệu: nó là khóa tìm kiếm để phát hiện tin mới.

Phát hiện Tin nhắn Mới

Để xác định email mới từ danh sách email trên máy chủ POP3:

Kết nối tới máy chủ.
Lấy danh sách email.
Kết nối đến cơ sở dữ liệu.
Lấy danh sách email.
So sánh các danh sách.
Lưu các email mới vào cơ sở dữ liệu.

Quá trình nhanh hơn khi bạn:

Lấy tất cả ID duy nhất của các tin nhắn vào bảng băm.
Tìm trong bảng băm thay vì cơ sở dữ liệu cho mỗi tin nhắn email trong vòng lặp foreach(…)

Thay vì truy vấn cơ sở dữ liệu cho mỗi tin nhắn, đòi hỏi nhiều lần gọi cơ sở dữ liệu, phương pháp này chỉ cần một lần gọi. Đoạn mã dưới đây cho bạn thấy cách phát hiện các tin nhắn Email mới trên máy chủ POP3.

Net: Đọc tin nhắn Email từ Thư viện Tài liệu Microsoft SharePoint

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

Bài viết này chỉ cách đọc tin nhắn email từ một thư viện tài liệu Microsoft SharePoint. Để truy cập các tệp trong thư viện tài liệu SharePoint, SDK của SharePoint phải được cài đặt trên hệ thống. SDK cung cấp API cần thiết để đăng nhập và truy cập các tệp từ thư viện tài liệu.

Đọc tin nhắn Email từ SharePoint

Các mẫu lập trình dưới đây giả định rằng một tệp Microsoft Outlook Message (.msg) đã được lưu trong thư mục SharedDocument của Thư viện Tài liệu SharePoint. SDK của SharePoint được sử dụng để lấy tệp tin tin nhắn vào một luồng và sau đó truyền luồng này cho một thể hiện của Aspose.Email MailMessage lớp. Lớp MailMessage tải luồng và phân tích tệp tin Outlook. Sau đó, truy cập các thuộc tính của lớp MailMessage, ví dụ, chủ đề, nội dung văn bản, nội dung HTML, v.v., để sử dụng thông tin trong một dự án Visual Studio. Để biết thông tin về cách cài đặt và cấu hình Microsoft SharePoint Server và SDK, vui lòng tham khảo các phần tương ứng trong thư viện MSDN. Đoạn mã dưới đây cho bạn thấy cách đọc tin nhắn email từ SharePoint.

Net: Đặt Mã hoá Văn bản Mặc định trong Tin Email

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

Bài viết này giới thiệu MailMessage.PreferredTextEncoding thuộc tính và giải thích cách sử dụng. Bằng thuộc tính này, bạn có thể đặt mã hoá văn bản mặc định cho các thuộc tính sau:

Từ: Tên hiển thị
Đến: Tên hiển thị
Tiêu đề
Nội dung

Đặt Mã hoá Văn bản Mặc định

Trong các phiên bản trước của Aspose.Email, mã hoá văn bản cho các thuộc tính from, to, subject và body được đặt riêng biệt. Để cải thiện tính tiện dụng, chúng tôi đã thêm PreferredTextEncoding thuộc tính cho phép đặt tất cả cùng một lúc. Giờ đây dễ dàng hơn để đảm bảo rằng toàn bộ văn bản trong các thuộc tính trên được mã hoá đúng trong tin email. Đoạn mã dưới đây cho bạn thấy cách sử dụng một từ tiếng Pháp làm tên hiển thị cho địa chỉ email, tiêu đề và nội dung.

Net: Chuyển đổi tệp tin Outlook Message (MSG) sang ảnh TIFF

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

Trong bài viết này, chúng tôi chỉ cho bạn cách chuyển đổi tệp Outlook MSG sang hình ảnh TIFF.

Đầu tiên, đọc một tệp MSG và chuyển đổi nó sang định dạng MHTML bằng Aspose.Email cho .NET. Sử dụng Aspose.Email.MailMessage lớp để tải tệp tin tin nhắn.
Sau khi tải tệp, gọi MailMessage.Save() phương thức và lưu nó vào luồng ở định dạng MHTML.
Sử dụng Aspose.Words cho .NET để chuyển đổi luồng MHTML sang TIFF. Sử dụng Aspose.Words.Document lớp để tải luồng MHTML.
Cuối cùng, gọi Document.Save() phương thức để lưu tài liệu MHTML thành TIFF.

Nếu tài liệu chứa nhiều trang, một tệp TIFF đa trang sẽ được tạo ra. Các đoạn mã dưới đây cho thấy cách chuyển đổi tệp Outlook Message (MSG) sang hình ảnh TIFF.

Net: Sử dụng tài liệu Microsoft Word làm nội dung tin nhắn và gửi email

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

Bài viết này chỉ cho bạn cách sử dụng tài liệu Microsoft Word làm nội dung email và gửi tới người nhận. Tài liệu mẫu là một hoá đơn bán hàng từ cơ sở dữ liệu mẫu Northwind, đã được xuất sang định dạng Microsoft Word. Aspose.Email cho .NET xử lý các giao thức mạng và tính năng của Microsoft Outlook và không thể xử lý tài liệu Microsoft Word. Để khắc phục, các mẫu trong bài viết này sử dụng Aspose.Words cho .NET để tải tài liệu Word và chuyển đổi nó sang định dạng MHTML. Aspose.Email cho .NET sử dụng tài liệu MHTML trong nội dung email.

Sử dụng tài liệu Microsoft Word làm nội dung email

Các mẫu lập trình dưới đây minh họa cách gửi một tài liệu Word làm nội dung email bằng Aspose.Words cho .NET và Aspose.Email cho .NET:

Tải tài liệu Microsoft Word bằng Aspose.Word cho .NET Document lớp.
Lưu nó ở định dạng MHTML.
Tải tài liệu MHTML bằng Aspose.Email cho .NET MailMessage lớp để đặt nội dung email.
Đặt các thuộc tính tin nhắn khác bằng cách sử dụng các MailMessage các thuộc tính và phương thức của lớp.
Gửi email bằng Aspose.Email cho .NET SMTPClient lớp.

Tài liệu nguồn, một hoá đơn bán hàng đã được xuất sang Microsoft Word từ mẫu Microsoft Northwind có thể xem ở dưới.

Khi tin nhắn đã được gửi và nhận trong Microsoft Outlook, nó trông giống như tin nhắn dưới đây.

Định dạng HTML và hình ảnh được giữ nguyên như trong tài liệu nguồn gốc khi xem trong Outlook hoặc trình khách email web như Gmail hay Hotmail. Dưới đây là ảnh chụp màn hình của tin nhắn khi mở bằng Gmail trên trình duyệt Chrome.

Đoạn mã dưới đây cho bạn thấy cách sử dụng tài liệu Microsoft Word làm nội dung tin nhắn và gửi email bằng cách sử dụng SmtpClient đối tượng lớp.

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

// Load a Word document from disk and save it to stream as MHTML
Document wordDocument = new Document(folderPath + "invoice.docx");
MemoryStream mhtmlStream = new MemoryStream();
wordDocument.Save(mhtmlStream, SaveFormat.Mhtml);

// Load the MHTML in a MailMessage object
mhtmlStream.Position = 0;
using (MailMessage message = MailMessage.Load(mhtmlStream, new MhtmlLoadOptions()))
{
    message.Subject = "Sending Invoice by Email";
    message.From = "sender@gmail.com";
    message.To = "recipient@gmail.com";

    // Save the message in MSG format to disk
    message.Save(folderPath + "WordDocAsEmailBody_out.msg", SaveOptions.DefaultMsgUnicode);

    // Send the email message
    using (SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "sender@gmail.com", "password"))
    {
        client.SecurityOptions = SecurityOptions.SSLExplicit;
        client.Send(message);
    }
}

Net: Tính năng In của Aspose.Email

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

Tính năng In ấn

Cái Aspose.Email.Printing namespace cung cấp một bộ tính năng phong phú để in tin nhắn email sang các định dạng khác nhau (XPS hoặc TIFF) và cấu hình bố cục trang. Bài viết này mô tả chúng. Có một số tùy chọn để in tin nhắn email từ Aspose.Email:

Chỉ in nội dung tin nhắn.
In nội dung tin nhắn và tiêu đề.
In nội dung HTML.
Cài đặt bố cục trang.
Tự động điều chỉnh kích thước TIFF cho máy in.
Điều chỉnh DPI mục tiêu cho TIFF đầu ra.

In nội dung tin nhắn

Đoạn mã sau cho bạn thấy cách tạo một tin nhắn và in nó mà không có phần tiêu đề, đầu tiên vào tệp XPS và sau đó vào tệp TIFF.

In tiêu đề và nội dung tin nhắn

Đoạn mã sau cho bạn thấy cách hiển thị tiêu đề và in chúng cùng với nội dung tin nhắn, thay đổi FormattingFlags đến MailInfo.

In tin nhắn với nội dung HTML

Các tin nhắn có nội dung HTML cũng có thể được in. Đoạn mã sau cho bạn thấy cách in một tin nhắn có nội dung HTML.

Cài đặt bố cục trang khi in

Aspose.Email.Printing.MailPrinter cung cấp các điều khiển để thiết lập các thuộc tính sau của bố cục trang:

Có hai cờ: MailInfo và None
Đơn vị trang có thể là Inch, Pixel, Point, Cm hoặc Millimeter.

Đoạn mã sau sử dụng các thiết lập tùy ý để minh họa cách sử dụng các thuộc tính này. Nó thiết lập một trang cao 20 cm và rộng 8 cm, với lề 2 cm.

Tự động điều chỉnh TIFF

Aspose.Email.Printing cung cấp MessageFormattingFlags.AutoFitWidth thuộc tính cho phép bạn tự động điều chỉnh kích thước TIFF cho máy in. Đoạn mã sau cho bạn thấy cách sử dụng Auto-fit.

Điều chỉnh DPI mục tiêu cho TIFF đầu ra

Đoạn mã sau cho bạn thấy cách sử dụng DPI cho TIFF đầu ra.

Net: Sử dụng một Worksheet Excel của Microsoft làm Nội dung Thông điệp và Gửi Email

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

Bài viết này sử dụng một sổ làm việc Microsoft Excel làm nội dung email và gửi tới người nhận. Aspose.Email cho .NET xử lý các giao thức mạng và tính năng của Microsoft Outlook và không thể xử lý các sổ làm việc Microsoft Excel. Để khắc phục, các mẫu trong bài viết này sử dụng Aspose.Cells cho .NET để tải sổ Excel và chuyển đổi nó thành luồng HTML. Sau đó, Aspose.Email cho .NET sử dụng luồng HTML đó trong nội dung email. Mẫu lập trình cho thấy cách gửi một worksheet Excel làm nội dung Email bằng Aspose.Cells cho .NET và Aspose.Email cho .NET

Tải một sổ làm việc Microsoft Excel bằng lớp Workbook của Aspose.Cells
Lưu sổ làm việc đã tải vào MemoryStream ở định dạng HTML
Lấy HTML từ luồng dưới dạng String
Định nghĩa một đối tượng MailMessage mới và đặt HtmlBody của nó thành nội dung HTML từ bước 3
Gửi email bằng lớp SmtpClient của Aspose.Email cho .NET

Sổ làm việc Excel nguồn có thể được xem như sau:

Khi tin nhắn đã được gửi và nhận trong Microsoft Outlook, nó trông giống như tin nhắn dưới đây:

Đoạn mã sau cho bạn thấy cách gửi Worksheet Excel của MS làm Nội dung Thông điệp và Gửi Email.

Net: Lớp wrapper để tải Email Messages không đồng bộ bằng Aspose.Email

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

Lớp Wrapper để tải Email Messages

Có một số trường hợp cần tính năng Time out để hủy một hành động kéo dài không cần thiết. Bài viết này cung cấp một lớp mẫu để thực hiện tính năng Time out khi tải các tệp EML/MSG có thể gây ra độ trễ lâu dài hoặc không tải được. Vì Time out không liên quan trực tiếp đến hoạt động đọc/ghi đĩa hay mạng, nên việc triển khai tính năng này trong API ít hữu ích hơn so với việc thực hiện ở phía người dùng bằng cách viết một lớp wrapper quanh Aspose.

Việc hủy một luồng chạy lâu có thể đạt được bằng cách sử dụng một delegate được bao bọc, truyền ra luồng cần bị kill, trong một biến cục bộ bên trong phương thức khởi tạo. Luồng chạy lâu được hủy bằng cách abort và quyền điều khiển được trả lại cho ứng dụng chính. Đoạn mã mẫu dưới đây cung cấp một lớp wrapper mẫu quanh thư viện Aspose.Email. Mã cũng minh họa cách sử dụng mẫu của lớp wrapper.

Mẫu Lập Trình với .NET 3.5 trở lên

Mẫu Lập Trình với .NET 2.0

Ví Dụ Sử Dụng

Net: Tạo các lần lặp lại từ Mẫu Lặp lại

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

Với Aspose.Email, có thể tạo các lần xuất hiện bằng cách sử dụng mẫu lặp lại. Bài viết này giải thích cách, cách thực hiện tạo lần xuất hiện tiếp theo và lấy mô tả mục thân thiện với người dùng. Các lần xuất hiện từ mẫu lặp lại lịch MAPI có thể được tạo bằng Aspose.Email. Đoạn mã dưới đây cho bạn thấy cách tạo các lần xuất hiện từ các mẫu lặp lại.

Tính lần xuất hiện tiếp theo hoặc n lần xuất hiện tiếp theo

Để lấy lần xuất hiện "tiếp theo", sử dụng phương thức GenerateOccurrences với tham số nNextOccurrences=1. Đoạn mã dưới đây cho bạn thấy cách tạo ra 20 lần xuất hiện bằng cách sử dụng nNextOccurrences = 20. Kết quả của đoạn mã dưới đây như sau:

Lấy Văn bản Thân thiện với Người dùng cho Lặp lại

Văn bản thân thiện với người dùng cho một quy tắc có thể được lấy bằng cách sử dụng thuộc tính FriendlyText như dưới đây. Kết quả của mã sẽ là: "Lặp lại mỗi tháng vào ngày 1 và ngày 1 tính từ cuối ngày của tháng, tối đa 2 lần lặp lại.". Đoạn mã sau cho bạn thấy cách lấy văn bản thân thiện với người dùng cho một chu kỳ lặp lại.

Net: Truy cập Dịch vụ Mail bằng OAuth

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

Hỗ trợ OAuth 2.0 đã được thêm vào Aspose.Email và có thể được sử dụng để truy cập các máy chủ SMTP, POP3, IMAP và EWS. Nói chung, tất cả các máy chủ hỗ trợ token bearer OAuth 2.0 có thể được sử dụng với Aspose.Email, nhưng các client email của chúng tôi đã được kiểm tra với máy chủ thư của Google và Microsoft Office 365. Truy cập máy chủ từ SmtpClient, Pop3Client, ImapClient và EWSClient với OAuth có thể được triển khai theo 2 cách.

Cung cấp token truy cập trực tiếp vào hàm khởi tạo của client email. Trong trường hợp này, người dùng phải hiểu rằng thời gian sống của token truy cập có giới hạn. Khi token hết hạn, client email không thể được sử dụng để truy cập máy chủ.
Cung cấp một triển khai tùy chỉnh của nhà cung cấp token dựa trên ITokenProvider giao diện vào hàm khởi tạo của client email. Trong trường hợp này, client sẽ kiểm tra thời gian hết hạn token và yêu cầu ITokenProvider để lấy token truy cập mới khi token trước đó đã hết hạn. Bằng cách này, client sẽ làm mới token định kỳ và có thể làm việc với máy chủ vô thời hạn. Thông thường các dịch vụ hỗ trợ một cách đơn giản để làm mới token truy cập. Ví dụ, sử dụng refresh token trong các dịch vụ của Google hoặc luồng xác thực ROPC trong nền tảng nhận diện của Microsoft có thể được dùng cho việc triển khai nhà cung cấp token.

Cấu hình tài khoản trên máy chủ phù hợp

Các bài viết sau sẽ giúp bạn cấu hình tài khoản để truy cập dịch vụ thư.

Cho Office 365
Cho Gmail

Truy cập Dịch vụ Thư với Token Truy cập

Các ví dụ mã sau cho bạn thấy cách kết nối tới dịch vụ thư bằng token truy cập.

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.gmail.com",
    587,
    "user1@gmail.com",
    "accessToken",
    true,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
   "imap.gmail.com",
   993,
   "user1@gmail.com",
   "accessToken",
   true,
   SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "pop.gmail.com",
   995,
   "user1@gmail.com",
   "accessToken",
   true,
   SecurityOptions.Auto))
{

}

Truy cập Dịch vụ Thư với Các Nhà cung cấp Token

Các ví dụ mã sau cho bạn thấy cách kết nối tới dịch vụ thư bằng một nhà cung cấp token.

ITokenProvider tokenProvider = TokenProvider.Google.GetInstance(
    "ClientId",
    "ClientSecret",
    "RefreshToken");

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.gmail.com",
    587,
    "user1@gmail.com",
    tokenProvider,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
   "imap.gmail.com",
   993,
   "user1@gmail.com",
   tokenProvider,
   SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "pop.gmail.com",
   995,
   "user1@gmail.com",
   tokenProvider,
   SecurityOptions.Auto))
{

}

Triển khai ITokenProvider tùy chỉnh cho Office 365

Bạn có thể sử dụng triển khai nhà cung cấp token dưới đây để truy cập các dịch vụ thư của Office 365.

using JsonConvert = Newtonsoft.Json.JsonConvert;
using Aspose.Email.Clients;
using Aspose.Email.Common.Utils;
using Aspose.Email.Tests.TestUtils;
using Newtonsoft.Json;
using System;
using System.IO;
using System.Net;
using System.Text;

namespace TestNS
{
    /// <summary>
    /// Azure resource owner password credential (ROPC) token provider
    /// https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
    /// https://portal.azure.com
    /// https://developer.microsoft.com/en-us/graph/graph-explorer/#
    /// token parser https://jwt.io
    /// </summary>
    internal class AzureROPCTokenProvider : ITokenProvider
    {
        private const string uriFormat = "https://login.microsoftonline.com/{0}/oauth2/v2.0/token";
        private const string bodyFormat =
            "client_id={0}" +
            "&scope={1}" +
            "&username={2}" +
            "&password={3}" +
            "&grant_type={4}";

        private readonly string scope;
        private const string grant_type = "password";
        private readonly object tokenSyncObj = new object();
        private OAuthToken token;
        private readonly string tenant;
        private readonly string clientId;
        private readonly string clientSecret;
        private readonly string userName;
        private readonly string password;

        /// <summary>
        /// Initializes a new instance of the <see cref="AzureROPCTokenProvider"/> class
        /// </summary>
        /// <param name="tenant"></param>
        /// <param name="clientId"></param>
        /// <param name="clientSecret"></param>
        /// <param name="scope"></param>
        /// <param name="userName"></param>
        /// <param name="password"></param>
        /// <param name="scopeAr"></param>
        public AzureROPCTokenProvider(
            string tenant, 
            string clientId, 
            string clientSecret, 
            string userName, 
            string password,
            string[] scopeAr)
        {
            this.tenant = tenant;
            this.clientId = clientId;
            this.clientSecret = clientSecret;
            this.userName = userName;
            this.password = password;
            this.scope = string.Join(" ", scopeAr);
        }

        /// <summary>
        /// Gets oAuth access token. 
        /// </summary>
        /// <param name="ignoreExistingToken">
        /// If ignoreExistingToken is true, requests new token from a server. Otherwise behaviour is depended on whether token exists or not.
        /// If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        /// </param>
        /// <returns>Returns oAuth access token</returns>
        public virtual OAuthToken GetAccessToken(bool ignoreExistingToken)
        {
            lock (tokenSyncObj)
            {
                if (this.token != null && !this.token.Expired && !ignoreExistingToken)
                    return this.token;
                token = null;
                string uri = string.Format(uriFormat, string.IsNullOrWhiteSpace(tenant) ? "common" : tenant);
                HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(uri);
                string body = string.Format(bodyFormat,
                    HttpUtility.UrlEncode(clientId),
                    HttpUtility.UrlEncode(scope),
                    HttpUtility.UrlEncode(userName),
                    HttpUtility.UrlEncode(password),
                    HttpUtility.UrlEncode(grant_type));
                byte[] bytes = Encoding.ASCII.GetBytes(body);
                request.Method = "POST";
                request.ContentType = "application/x-www-form-urlencoded";
                request.ContentLength = bytes.Length;
                MemoryStream ms = new MemoryStream(bytes);
                using (Stream requestStream = request.GetRequestStream())
                    requestStream.Write(bytes, 0, bytes.Length);
                HttpWebResponse response = (HttpWebResponse)request.GetResponse();
                StringBuilder responseText = new StringBuilder();
                bytes = new byte[1024];
                int read = 0;
                using (Stream stream = response.GetResponseStream())
                {
                    while ((read = stream.Read(bytes, 0, bytes.Length)) > 0)
                        responseText.Append(Encoding.ASCII.GetString(bytes, 0, read));
                }
                string jsonString = responseText.ToString();
                AzureTokenResponse t = JsonConvert.DeserializeObject<AzureTokenResponse>(jsonString);
                token = new OAuthToken(
                    t.access_token,
                    TokenType.AccessToken,
                    DateTime.Now.AddSeconds(t.expires_in));
                return token;
            }
        }

        /// <summary>
        /// Gets oAuth access token.
        /// If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        /// </summary>
        /// <returns>Returns oAuth access token</returns>
        public OAuthToken GetAccessToken()
        {
            return GetAccessToken(false);
        }

        /// <summary>
        /// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
        /// </summary>
        public virtual void Dispose()
        {
        }
    }

    /// <summary>
    /// A success response contains a JSON OAuth 2.0 response with the following parameters.
    /// </summary>
    public class AzureTokenResponse
    {
        /// <summary>
        /// The requested access token. The calling web service can use this token to authenticate to the receiving web service.
        /// </summary>
        public string access_token { get; set; }

        /// <summary>
        /// Indicates the token type value. The only type that Azure AD supports is Bearer For more information about bearer tokens, 
        /// see The OAuth 2.0 Authorization Framework: Bearer Token Usage (RFC 6750).
        /// </summary>
        public string token_type { get; set; }

        /// <summary>
        /// How long the access token is valid (in seconds).
        /// </summary>
        public int expires_in { get; set; }

        /// <summary>
        /// How long the access token is valid (in seconds).
        /// </summary>
        public int ext_expires_in { get; set; }

        /// <summary>
        /// The time when the access token expires. 
        /// The date is represented as the number of seconds from 1970-01-01T00:00:00Z UTC until the expiration time.
        /// This value is used to determine the lifetime of cached tokens.
        /// </summary>
        public int expires_on { get; set; }

        /// <summary>
        /// The App ID URI of the receiving web service.
        /// </summary>
        public string resource { get; set; }

        /// <summary>
        /// If an access token was returned, this parameter lists the scopes the access token is valid for.
        /// </summary>
        public string scope { get; set; }

        /// <summary>
        /// Issued if the original scope parameter included the openid scope.
        /// </summary>
        public string id_token { get; set; }

        /// <summary>
        /// Issued if the original scope parameter included offline_access.
        /// </summary>
        public string refresh_token { get; set; }
    }
}

Các ví dụ mã sau sẽ cho bạn thấy cách kết nối tới các dịch vụ Office 365 bằng cách sử dụng nhà cung cấp token tùy chỉnh.

ITokenProvider tokenProvider = new AzureROPCTokenProvider(
    "Tenant",
    "ClientId",
    "ClientSecret",
    "EMail",
    "Password",
    scopes);

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.office365.com",
    587,
    "Test1@test.onmicrosoft.com",
    tokenProvider,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
    "outlook.office365.com",
    993,
    "Test1@test.onmicrosoft.com",
    tokenProvider,
    SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "outlook.office365.com",
   995,
   "Test1@test.onmicrosoft.com",
   tokenProvider,
   SecurityOptions.Auto))
{

}

// Connecting to EWS server
const string mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
ICredentials credentials = new OAuthNetworkCredential(tokenProvider);
using (IEWSClient ewsClient = EWSClient.GetEWSClient(mailboxUri, credentials))
{

}

Net: Phân biệt giữa Tệp đính kèm Inline và Thường

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

Đây là một kịch bản phổ biến khi một tin nhắn email có thể chứa hình ảnh inline trong nội dung cũng như các tệp đính kèm thường đi kèm. Sử dụng MailMessage lớp, các tệp đính kèm inline có thể được giải nén từ LinkedResourceCollection lớp, trong khi các tệp đính kèm thường có thể được truy cập/giải nén bằng AttachmentCollection lớp của một tin nhắn. Tuy nhiên, điều này khác khi tin nhắn được tải bằng lớp Aspose.Email.Mapi.MapiMessage, vì tất cả các hình ảnh inline và tệp đính kèm thường đều có thể truy cập bởi người dùng trong cùng một lớp MapiAttachmentCollection. Do đó, cần thiết kế một phương pháp có thể phân biệt giữa tệp đính kèm inline và tệp đính kèm thường khi sử dụng MapiMessage.

Sử dụng Aspose.Email để phân biệt giữa Tệp đính kèm Inline và Thường

Bài viết này giải thích cách phân biệt tệp đính kèm inline và thường bằng cách sử dụng MapiMessage. Để xác định sự phân biệt này, loại nội dung của MapiMessage được xét như sau:

Nội dung Văn bản Thuần: Các email có loại nội dung văn bản thuần không cần kiểm tra, vì tất cả các tệp đính kèm trong những tin nhắn này luôn luôn là tệp đính kèm thường.

Nội dung Html: Trong trường hợp một tin nhắn có loại nội dung HTML, tệp đính kèm không chỉ cần chứa thuộc tính PR_ATTACH_FLAGS (0x37140003), mà giá trị của nó cũng phải bằng 0x00000004 cho tệp đính kèm inline. Nếu điều kiện này được đáp ứng, thì tiếp theo còn phụ thuộc vào các thẻ PR_ATTACH_CONTENT_LOCATION và PR_ATTACH_CONTENT_ID để xác định tính chất của tệp đính kèm. Tuy nhiên, nếu không có thẻ PR_ATTACH_FLAGS của Mapi, tệp đính kèm sẽ được kiểm tra thuộc tính PR_ATTACH_DISPOSITION (0x3716001F hoặc 0x3716001E) để xác định loại tệp đính kèm.

Nội dung Rtf: Nếu nội dung là RTF, thì tất cả các tệp đính kèm OLE đều là tệp đính kèm inline. Giá trị của PR_ATTACH_METHOD cho tất cả các tệp đính kèm OLE bằng 0x00000006.

Đoạn mã mẫu sau minh họa cách phân biệt một cách lập trình giữa tệp đính kèm inline và thường. Hàm IsInlineAttachment nhận một tệp đính kèm và Message BodyType làm tham số đầu vào và trả về true nếu tệp đính kèm là dạng Inline.

Net: Gửi Thư Sử Dụng DNS

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

Đôi khi việc gửi email bằng máy chủ SMTP không đáp ứng được yêu cầu của dự án. Chúng ta có thể muốn sử dụng bản ghi MX của tên miền người nhận. Đoạn mã sau cho thấy cách gửi email bằng máy chủ thư của miền người nhận.

Net: Trích xuất dữ liệu Đối tượng Nhúng

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

Đôi khi dữ liệu OLE nhúng được biểu diễn dưới dạng tệp đính kèm "oleData.mso" bởi MapiAttachment và cần được trích xuất thủ công. Các tệp oleData.mso này là định dạng Microsoft Computer Document File (MCDF) và việc hỗ trợ các tệp như vậy vượt quá phạm vi của Aspose.Email. Tuy nhiên, Aspose.Email có thể được sử dụng kết hợp với các thư viện mã nguồn mở khác, chẳng hạn như OpenMCDF, để đọc nội dung của các tệp này và lưu vào đĩa. Aspose.Email cung cấp the InlineAttachmentExtractor lớp để liệt kê các gói MSO từ dữ liệu nhị phân của oledata.mso, sau đó có thể được dùng để trích xuất nội dung bằng các thư viện đọc Compound Files.

Nếu loại nội dung tin là HTML (không phải RTF), và có các đối tượng OLE trong tin, thuộc tính MapiPropertyTag.PR_ATTACH_DATA_OBJ sẽ không tồn tại. Trong trường hợp này, thông tin về các đối tượng OLE được chứa trong oldedata.mso.

Trích xuất Đối tượng Nhúng

Bài viết này cho thấy cách trích xuất nội dung từ tệp như vậy bằng Aspose.Email và OpenMCDF. Điều này có thể thực hiện như sau:

Liệt kê các gói MSO từ dữ liệu nhị phân của tệp đính kèm oledata.mso
đối với mỗi dữ liệu OLE, đọc CompoundFile
Đọc luồng bằng CONTENTS
Lưu nội dung vào FileStream

Net: Lưu Email dưới dạng PDF

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

Bài viết này chỉ cách chuyển đổi một tin nhắn email sang PDF bằng Aspose.Email. Aspose.Email cho .NET xử lý các giao thức mạng và tính năng của Microsoft Outlook, và không thể thực hiện chuyển đổi trực tiếp sang PDF. Để khắc phục, các mẫu trong bài viết này sử dụng Aspose.Email để chuyển đổi tin nhắn email thành luồng MHTML và sau đó dùng Aspose.Words cho .NET để tải luồng MHTML và lưu nó dưới dạng PDF. Một tin nhắn email cũng có thể chứa tệp đính kèm. Vì mỗi tệp đính kèm có thể có các loại phương tiện khác nhau, Aspose.Email sẽ bỏ qua các tệp đính kèm này khi chuyển đổi sang MHTML, tức là chỉ các hình ảnh inline trong tin nhắn sẽ là một phần của MHTML và bất kỳ tệp đính kèm thường nào sẽ bị bỏ qua.

Chuyển đổi tin nhắn Email sang PDF

Đoạn mã dưới đây cho thấy việc chuyển đổi tin nhắn email sang PDF bằng Aspose.Email kết hợp với Aspose.Words cho .NET. Điều này bao gồm các bước sau:

Tải tin nhắn email bằng cách sử dụng MailMessage
Lưu tin email vào MemoryStream dưới dạng MHTML
Tải luồng bằng Aspose.Words
Lưu tin dưới dạng PDF

Tin email nguồn có thể được xem như sau:

PDF đã chuyển đổi được hiển thị trong hình ảnh sau:

Đoạn mã dưới đây cho bạn thấy cách chuyển đổi tin nhắn email sang PDF.

string dataDir = RunExamples.GetDataDir_KnowledgeBase();
MailMessage mailMsg = MailMessage.Load(dataDir + "message3.msg");
MemoryStream ms = new MemoryStream();
mailMsg.Save(ms, Aspose.Email.SaveOptions.DefaultMhtml);

// create an instance of LoadOptions and set the LoadFormat to Mhtml
var loadOptions = new Aspose.Words.Loading.LoadOptions();
loadOptions.LoadFormat = LoadFormat.Mhtml;

// create an instance of Document and load the MTHML from MemoryStream
var document = new Aspose.Words.Document(ms, loadOptions);

// create an instance of HtmlSaveOptions and set the SaveFormat to Html
var saveOptions = new Aspose.Words.Saving.PdfSaveOptions();
document.Save(dataDir + "SaveEmailAsPDF_out.pdf", saveOptions);

Net: Gửi yêu cầu họp với lặp lại

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

Với Aspose.Email, có thể tạo một yêu cầu họp có lặp lại. Bài viết này giải thích cách tạo một yêu cầu họp với lịch lặp lại cụ thể. ID duy nhất của cuộc hẹn có thể được lưu để sử dụng sau này khi gửi bất kỳ cập nhật nào cho cuộc hẹn.

Tạo yêu cầu họp với lặp lại

Mẫu mã dưới đây cho thấy cách thực hiện điều này.

Gửi yêu cầu cập nhật lịch hẹn

Để gửi cập nhật cho cuộc hẹn trước, cần có ID duy nhất. Mã mẫu dưới đây cho thấy cách gửi yêu cầu cập nhật cuộc hẹn này

Net: Hỗ trợ đa luồng trong các client email

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

Các khách hàng thư như ImapClient và Pop3Client cho phép người dùng sử dụng chúng trong môi trường đa luồng. Khách hàng thư cho phép có một hoặc nhiều kết nối với máy chủ. Để quản lý một tập hợp các kết nối bên trong khách hàng, sử dụng pool kết nối. Số lượng kết nối có thể tạo và sử dụng đồng thời bị giới hạn bởi thuộc tính CredentialsByHostClient.MaxConnectionsPerServer. Thuộc tính này có thể đặt thành 1 hoặc giá trị lớn hơn. Mặc định thuộc tính này bằng 10. Hàng đợi lệnh đã được triển khai cho kết nối để hỗ trợ các thao tác đa luồng. Các lệnh thực hiện các thao tác đơn giản nhất được định nghĩa trong giao thức, như Noop, Authenticate, v.v. Người dùng có thể bắt đầu thực thi một số lượng lệnh lớn hơn số kết nối khả dụng. Tuy nhiên, chúng chỉ được thực thi khi khách hàng có thể tạo kết nối cho thao tác đó.

Các phương pháp sử dụng khách hàng thư trong môi trường đa luồng

Các client email có hành vi sau:

1. Khi MaxConnectionsPerServer = 1, client tạo 1 kết nối, thực hiện xác thực và ủy quyền. Kết nối này duy trì ở trạng thái hoạt động cho đến khi client được giải phóng. Tất cả các thao tác từ các luồng khác nhau được đưa vào một hàng đợi lệnh đặt trong kết nối chính.

2. Khi MaxConnectionsPerServer > 1, client tạo số lượng kết nối cần thiết, thực hiện xác thực và ủy quyền cho mỗi kết nối. Một kết nối được dành làm kết nối chính. Kết nối này được duy trì ở trạng thái hoạt động cho đến khi client được giải phóng. Tất cả các kết nối khác được tạo và giải phóng theo yêu cầu. Số lượng tối đa của các kết nối như vậy được xác định bởi thuộc tính MaxConnectionsPerServer, ví dụ nếu MaxConnectionsPerServer = 2 thì một kết nối được dành làm kết nối chính, và kết nối thứ hai được dùng làm bổ sung cho các thao tác thực hiện trong các luồng khác. Tương tự, nếu MaxConnectionsPerServer = 3 thì kết nối đầu tiên là kết nối chính, và hai kết nối còn lại được dùng làm bổ sung cho các thao tác thực hiện trong các luồng khác. Trong trường hợp có yêu cầu kết nối tiếp theo từ luồng mới, và tất cả các kết nối đã được sử dụng, client sẽ chờ cho đến khi số lượng kết nối đang dùng giảm xuống. Đây là một điểm quan trọng giải thích tại sao việc giải phóng kết nối đúng cách lại rất quan trọng.

Ví dụ

Người dùng có thể thực hiện các hoạt động trong các luồng khác nhau theo một số cách. Chúng có thể được chia thành hai loại:

1. Người dùng sử dụng các phương thức bất đồng bộ (Begin/End) được định nghĩa trong client. Trong trường hợp này client email khởi chạy các luồng mới khi cần thiết. Trong client được triển khai hàng đợi tác vụ (xin đừng nhầm lẫn với hàng đợi lệnh trong kết nối). Tác vụ có thể được thực thi nếu có kết nối khả dụng. Khi số lượng kết nối đã sử dụng giảm xuống dưới giá trị giới hạn, client tạo kết nối mới, tạo luồng cho tác vụ hiện tại và thực thi tác vụ này. Ví dụ về việc sử dụng các hoạt động bất đồng bộ:

2. Người dùng có thể tạo luồng bằng các đối tượng như Thread, ThreadPool, Task hoặc bất kỳ đối tượng nào khác được dự định cho mục đích này. Người dùng cũng có thể sử dụng các luồng được tạo trong mã của bên thứ ba. Trong quá trình này, khách hàng có hai mô hình hành vi

a. Nếu người dùng không tạo các kết nối bổ sung cho các hoạt động trong luồng, tất cả các hoạt động cho luồng này sẽ được gửi vào hàng đợi lệnh tới kết nối chính. Một ví dụ về các hoạt động trong một luồng phụ mà không tạo kết nối mới, tất cả giao dịch đều được thực hiện qua kết nối chính:

b. Khi người dùng gọi phương thức để tạo kết nối mới cho luồng phụ, luồng này bị chặn cho đến khi giá trị hạn ngạch cho các kết nối mới được thay đổi để cho phép kết nối mới. Sau đó kết nối mới được tạo. Kết nối này được đặt làm kết nối mặc định cho tất cả các hoạt động trong luồng này. Khi tất cả các hoạt động trong luồng này hoàn thành, phải giải phóng kết nối. Để tạo kết nối mới, sử dụng phương thức CredentialsByHostClient.CreateConnection. Phương thức này trả về một đối tượng triển khai giao diện IDisposable. Để giải phóng kết nối, phải gọi phương thức Dispose. Việc tạo và giải phóng kết nối phải được thực hiện trong luồng mà các hoạt động mail được thực hiện. Cố gắng tạo kết nối mới trong luồng mà client mail đã được tạo sẽ dẫn đến lỗi, vì luồng này tại thời điểm đó không thể được dùng để tạo kết nối mới. Ngoài ra, việc tạo kết nối mới không khả thi khi MaxConnectionsPerServer = 1. Một ví dụ mã cho việc tạo kết nối mới trong luồng phụ:

Khuyến nghị

Cần lưu ý rằng nếu người dùng gửi tất cả lệnh tới kết nối chính, có thể xảy ra tình huống các lệnh từ các luồng khác nhau bị trộn lẫn. Người dùng nên hiểu lệnh nào phụ thuộc vào thứ tự của chúng và thực hiện các biện pháp đồng bộ cho những lệnh như vậy. Cũng cần xem xét khả năng thực thi lệnh trong các phiên khác nhau (IMAP/POP3). Các thao tác tốn thời gian nhất, như FetchMessage, AppendMessage và Send, có thể thực hiện bằng luồng mới và kết nối mới. Nhưng các thao tác nhanh như Delete nên thực hiện bằng kết nối chính. Lưu ý rằng việc khởi tạo kết nối mới là thao tác tốn thời gian đáng kể.

Net: Giới thiệu và Ứng dụng mẫu

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

Kịch Bản Sử Dụng Aspose.Email.Mail

Bài viết này đề xuất một số cách sử dụng tiềm năng cho Aspose.Email cho .NET, tập trung đặc biệt vào các tính năng lập trình email của thành phần.

Phần mềm bản tin

Cái Aspose.Email.Mail API có thể được sử dụng để tạo một ứng dụng bản tin mạnh mẽ. Nhờ hỗ trợ của Aspose.Email trong việc thêm các đối tượng nhúng (như hình ảnh, âm thanh, v.v.), có thể tạo các bản tin HTML phong phú đầy đủ hình ảnh (và các đối tượng nhúng khác). Sử dụng tính năng gửi thư hàng loạt của API Aspose.Email.Mail, cũng có thể gửi số lượng lớn email trong thời gian ngắn. Aspose.Email.Mail cũng cung cấp tính năng mail merge dựa trên mẫu có thể dùng để tạo mẫu bản tin. Mẫu bản tin có thể được sử dụng để thực hiện mail merge khi gửi bản tin hàng loạt. Có nhiều tác vụ khác mà Aspose.Email.Mail có thể thực hiện trong một ứng dụng email marketing.

Công cụ Marketing khác

Tương tự như các ứng dụng bản tin, nhiều loại phần mềm khác có thể được xây dựng bằng Aspose.Email.Mail. Sử dụng nó để tạo email marketing, công cụ gửi thư hàng loạt và e-campaign, và hơn nữa.

Ứng dụng doanh nghiệp

Aspose.Email.Mail có thể được sử dụng trong hầu hết các loại ứng dụng doanh nghiệp để thực hiện các tác vụ tiện ích:

Cảnh báo email: Gửi cảnh báo email để thông báo cho người dùng về các hoạt động.
Yêu cầu họp: Gửi yêu cầu họp kinh doanh bằng hỗ trợ iCalendar của Aspose.Email.Mail.
Báo cáo theo lịch email: Báo cáo là thành phần không thể thiếu trong hầu hết các ứng dụng kinh doanh. Nhiều báo cáo kinh doanh được tạo định kỳ. Sử dụng Aspose.Email.Mail để gửi báo cáo theo lịch qua email.

Khách hàng Email

Aspose.Email.Mail cũng có thể được sử dụng trong các client email để gửi email thông thường. Nó hỗ trợ tệp đính kèm, đối tượng nhúng, sự kiện iCalendar, mail merge, gửi email hàng loạt, v.v., vì vậy Aspose.Email.Mail là lựa chọn tốt nhất để tạo các ứng dụng client email trên Windows hoặc web.

Ứng Dụng Mẫu Aspose.Email.Mail

Để minh họa cách sử dụng Aspose.Email.Mail, chúng tôi sẽ tạo một ứng dụng có tên ‘My First Email’ thể hiện cách xây dựng một tin nhắn email với Lớp MailMessage và sau đó gửi nó bằng lớp SmtpClient.

Mail : Các bước ứng dụng mẫu

Vui lòng làm theo các bước dưới đây để tạo ứng dụng ‘My First Mail’ bằng Aspose.Email.

Mở Visual Studio.
Trong menu File, chọn New, sau đó Project. (Chọn tạo ứng dụng Windows bằng C# hoặc VB.NET).
Nếu bạn có giấy phép, hãy áp dụng nó để sử dụng phiên bản đầy đủ của Aspose.Email.
Nhập Aspose.Email DLL vào ứng dụng bằng cách nhấp chuột phải vào Reference trong Solution Explorer.
Thiết kế ứng dụng Windows của bạn: tạo giao diện nhận ba trường: From, To và Message.
Nhấp đúp vào nút Send trong chế độ thiết kế và viết mã của bạn trong trình soạn thảo.
Tạo một đối tượng của lớp MailMessage và sử dụng các thuộc tính của nó để tạo một tin nhắn email. (Các đối tượng của lớp MailMessage được dùng để tạo tin nhắn email được truyền tới máy chủ SMTP để giao bằng lớp SmtpClient).
Tạo một đối tượng của lớp SmtpClient và sử dụng các thuộc tính của nó để gửi một tin nhắn email.
Kiểm tra Ứng dụng Windows của bạn bằng cách nhấn F5.
Nhập địa chỉ vào các trường From và To.
Nhập tin nhắn vào trường Message Body.
Nhấn Send.

Các bước trên được mô tả dưới đây: nhấp đúp vào nút Send trong chế độ thiết kế và thêm đoạn mã sau:

Khi kết nối tới máy chủ hỗ trợ SSL, chúng ta cần đặt các thuộc tính đối tượng SMTPClient sau

Kết luận

Aspose.Email.Mail là một thành phần rất mạnh mẽ cho phép các nhà phát triển thực hiện hầu hết các nhiệm vụ liên quan đến email, như gửi email hàng loạt đa luồng, sử dụng mail merge, thêm tệp đính kèm, nhúng hình ảnh và âm thanh vào tin nhắn email, thêm sự kiện iCalendar vào email, nhận email và nhiều hơn nữa.

Aspose.Email.Pop3

Aspose.Email.Pop3 thực hiện giao thức Post Office Protocol v3 (POP3) trên nền tảng .NET. Nó cho phép các nhà phát triển .NET thêm tính năng truy vấn và nhận email vào ứng dụng .NET của họ mà không cần quan tâm đến chi tiết giao thức và độ phức tạp của lập trình email và mạng. Aspose.Email.Pop3 hỗ trợ tất cả các lệnh được định nghĩa trong chuẩn POP3, và cung cấp giao diện dễ sử dụng cùng mô hình đối tượng gọn gàng, trực quan. Nó giảm đáng kể độ khó học cho các nhà phát triển .NET.

Pop3 : Tính năng chính

Là một phần của Aspose.Email, Aspose.Email.Pop3 được thiết kế riêng cho .NET và được viết bằng mã C# quản lý. Nó cho phép bạn:

Kết nối và đăng nhập vào các máy chủ POP3.
Hỗ trợ APOP.
Truy vấn tin nhắn.
Lấy tin nhắn.
Hoàn toàn hỗ trợ kiểu lập trình bất đồng bộ.
Hỗ trợ SSL.

Kịch Bản Aspose.Email.Pop3

Aspose.Email.Pop3 có thể được các nhà phát triển sử dụng trong nhiều kịch bản khác nhau. Dưới đây, chúng tôi chia sẻ một số ví dụ.

Tự động hóa Email doanh nghiệp

Aspose.Email.Pop3 có thể được sử dụng để truy vấn hộp thư đến và lấy các tin nhắn email. Nó hoạt động mượt mà với thành phần gửi email, Aspose.Email.Mail. Aspose.Email hỗ trợ đầy đủ tự động hoá email. Gửi tin nhắn email bằng Aspose.Email.Mail và lấy tin nhắn bằng Aspose.Email.Pop3. Các tin nhắn email đã tải xuống sau đó có thể được phân tích bởi Aspose.Email.Mime.

Khách hàng Email

Aspose.Email.Pop3 có thể được sử dụng trong các ứng dụng client email để nhận email.

Pop3 : Ứng dụng mẫu

Ở đây, chúng tôi sẽ trình bày cách sử dụng Aspose.Email.Pop3. Lớp này có nhiều tính năng nhưng chúng ta sẽ tập trung vào cách kết nối tới máy chủ POP3 và lấy tin nhắn. Ví dụ minh họa cách tạo một ứng dụng trong Visual Studio cũng như các đoạn mã giúp ứng dụng hoạt động. Thực hiện các bước dưới đây để tạo một ứng dụng mẫu sử dụng Aspose.Email.Pop3.

Mở Visual Studio.
Trong menu File, chọn New rồi Project.
Chọn một ứng dụng Windows bằng C# hoặc VB.NET.
Nhập Aspose.Email.dll vào ứng dụng bằng cách nhấp chuột phải vào Reference trong Solution Explorer.
Bây giờ thiết kế một ứng dụng Windows như dưới đây.
Tạo một đối tượng Pop3Client.
Đặt tên máy chủ POP3, tên đăng nhập và mật khẩu trong đối tượng này.
Gọi các hàm Connect() và Login() của Pop3Client.
Tạo một thể hiện MailMessage và lấy email đầu tiên trong tài khoản của bạn vào nó bằng cách gọi hàm FetchMessage(). Điều này đưa tin nhắn đầu tiên từ tài khoản email của bạn vào thể hiện MailMessage.
Sử dụng các thuộc tính From, Subject và HtmlBody của đối tượng MailMessage để xem người gửi, tiêu đề và nội dung của tin nhắn.

Các bước trên được minh họa trong các ví dụ mã dưới đây. Sử dụng đoạn mã sau trong bất kỳ nút nào hoặc trong sự kiện OnLoad của biểu mẫu.

Đối với các máy chủ hỗ trợ SSL, chúng ta cần thay đổi các thuộc tính sau của đối tượng Pop3Client:

Aspose.Email.Imap

Aspose.Email.Imap thực hiện giao thức Internet Message Access Protocol (IMAP) trên các nền tảng .NET. Aspose.Email.Imap cho phép các nhà phát triển .NET thêm khả năng IMAP vào ứng dụng .NET của họ một cách nhanh chóng, mà không cần hiểu chi tiết giao thức. Thành phần hỗ trợ lấy và tải lên tin nhắn, kiểm tra trạng thái mới/đã đọc/chưa đọc của tin nhắn, v.v.

Imap : Tính năng chính

Aspose.Email.Imap cho phép bạn:

Lấy các tin nhắn email.
Tải lên các tin nhắn email.
Liệt kê các tin nhắn email trong các thư mục khác nhau.
Kiểm tra trạng thái của các tin nhắn email.
Làm việc với MailMessage.
Làm việc với hỗ trợ SSL.

Sử Dụng Aspose.Email.Imap

Aspose.Email.Imap thực hiện giao thức Internet Message Access Protocol trên các nền tảng .NET. Với nó, các nhà phát triển có thể dễ dàng truy vấn và quản lý email trên máy chủ IMAP, cũng như tạo, xóa hoặc đổi tên thư mục email. Sử dụng Aspose.Email.Imap, các nhà phát triển có thể tận dụng giao thức IMAP với các API dễ sử dụng. Họ có thể truy cập email từ bất kỳ máy tính nào vì email vẫn được lưu trên máy chủ. Với Aspose.Email.Imap, các nhà phát triển có thể tạo ứng dụng web hoặc desktop nhận và thao tác email từ máy chủ IMAP. Aspose đã triển khai giao thức IMAP dựa trên các chuẩn xác thực internet và RFC. Do đó, Aspose.Email.Imap là một triển khai an toàn và đầy đủ tính năng của giao thức IMAP với mô hình đối tượng và giao diện dễ hiểu.

Imap : Ứng dụng mẫu

Bài viết này giải thích cách sử dụng Aspose.Email.Imap. Chúng tôi tạo một ứng dụng nhỏ để lấy số lượng tin nhắn email trong tài khoản IMAP của bạn. Thực hiện các bước dưới đây để tạo một ứng dụng mẫu sử dụng Aspose.Email.Imap.

Mở Visual Studio.
Trong menu File, chọn New rồi Project.
Chọn một ứng dụng Windows bằng C# hoặc VB.NET.
Nhập Aspose.Email.dll vào ứng dụng này bằng cách nhấp chuột phải vào Reference trong Solution Explorer.
Tạo một thể hiện ImapClient bằng cách truyền tên máy chủ IMAP, tên đăng nhập và mật khẩu.
Gọi hàm Connect() của thể hiện ImapClient để kết nối tới máy chủ.
Gọi hàm SelectFolder() của thể hiện ImapClient để chọn thư mục bạn muốn đếm số tin nhắn.
Bây giờ gọi thuộc tính CurrentFolder.TotalMessageCount của thể hiện ImapClient để lấy số lượng tin nhắn email.

Imap : Ví dụ mã

Các ví dụ mã dưới đây được đặt phía sau nút hoặc trong sự kiện OnLoad của biểu mẫu. Chúng cho thấy cách thực hiện các bước đã mô tả ở trên bằng Aspose.Email.

Đối với các máy chủ email hỗ trợ SSL, thiết lập các thuộc tính sau của đối tượng ImapClient:

Aspose.Email.Exchange

Aspose.Email.Exchange Cho phép các nhà phát triển quản lý email trên Microsoft Exchange Server. Sử dụng thành phần này, bạn có thể kết nối, liệt kê tin nhắn và tải xuống email từ hộp thư của Exchange Server mà không cần hiểu chi tiết giao thức bên dưới. Thành phần hỗ trợ liệt kê tin nhắn, gửi email, tải xuống tin nhắn và lưu dưới định dạng eml hoặc msg trên đĩa cục bộ, v.v.

Exchange : Tính năng chính

Aspose.Email.Exchange cho phép bạn:

Kết nối tới các máy chủ Microsoft Exchange.
Liệt kê các tin nhắn email trong hộp thư Exchange.
Liệt kê các tin nhắn email từ các thư mục khác nhau, ví dụ: Inbox, Sent, Deleted hoặc Drafts.
Xóa tin nhắn trong bất kỳ thư mục nào trên Exchange Server.

Sử dụng Aspose.Email.Exchange

Với Aspose.Email.Exchange, các nhà phát triển có thể truy cập hộp thư Exchange Server từ các ứng dụng .NET của họ. Nó cung cấp một API dễ sử dụng để quản lý email trên các máy chủ Exchange. Các nhà phát triển có thể tạo các ứng dụng console, desktop hoặc web để quản lý email trong hộp thư Exchange.

Ứng dụng mẫu Aspose.Email.Exchange

Bài viết này trình bày cách sử dụng Aspose.Email.Exchange. Chúng tôi tạo một ứng dụng máy tính để bàn đơn giản kết nối tới hộp thư Exchange Server, lấy danh sách tin nhắn trong thư mục Inbox và hiển thị chúng trên biểu mẫu Windows.

Exchange : Các bước Ứng dụng mẫu

Mở Microsoft Visual Studio.
Tạo một dự án mới. (Chọn ngôn ngữ bạn muốn C# hoặc VB.NET)
Thêm tham chiếu tới Aspose.Email.dll vào dự án của bạn bằng cách nhấp chuột phải vào dự án và chọn Add Reference từ menu.
Thiết kế một biểu mẫu Windows giống như bên dưới:

Để chạy ứng dụng thành công, bạn cần có thông tin đăng nhập đúng để truy cập Exchange Server. Ở đây, chúng tôi lấy thông tin xác thực - URI của Exchange Server, tên người dùng, mật khẩu và miền - từ biểu mẫu Windows. Đây là một mẫu rất cơ bản nên các thuộc tính của tin nhắn - chủ đề, người gửi và người nhận - chỉ được hiển thị đơn giản trong listbox.

Exchange : Ví dụ mã

Thêm đoạn mã sau vào trình xử lý sự kiện click của nút List Messages.

Exchange : Kết quả

Ảnh chụp màn hình này hiển thị các tin nhắn được lấy từ Exchange Server. Phương thức ListMessages() trả về thông tin cơ bản như tiêu đề, người gửi, người nhận và ID tin nhắn. Để lấy toàn bộ tin nhắn, gọi phương thức ExchangeClient.SaveMessage(). (Cách sử dụng ExchangeClient.SaveMessage() được mô tả trong bài viết Lưu tin nhắn từ hộp thư Exchange Server ở định dạng EML và MSG.)

Aspose.Email.Mime

Multipurpose Internet Mail Extensions (MIME) là một tiêu chuẩn Internet mở rộng định dạng email để hỗ trợ văn bản trong các bộ ký tự khác ngoài US-ASCII, tệp đính kèm không phải văn bản, phần thân tin nhắn đa phần và thông tin tiêu đề trong các bộ ký tự không phải ASCII. Aspose.Email.Mime triển khai giao thức MIME trên các khung .NET. Nó hoạt động như một trình dịch vì có thể đọc email từ tệp (.eml, v.v.) hoặc từ bộ nhớ (chuỗi). Sau đó nó phân tích tệp email hoặc chuỗi thành các phần có ý nghĩa. Nếu bạn muốn duyệt qua một tệp email mà không cần quan tâm đến chi tiết giao thức MIME, ví dụ để trích xuất tệp đính kèm từ email, hãy sử dụng Aspose.Email.Mime.

Các tính năng chính

Aspose.Email.Mime hoạt động hoàn hảo với Aspose.Email.Pop3 và Aspose.Email.Mail.

Aspose.Email.Pop3 lấy các tin nhắn email từ một hộp thư được chỉ định.
Aspose.Email.Mail gửi tin nhắn email tới một hộp thư được chỉ định.
Aspose.Email.Mime là phần trung tâm của hai mục trên, và phân tích các tin nhắn email.

Net: Hủy Yêu cầu Họp bằng Lịch

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

Bạn có thể gửi yêu cầu hủy họp bằng Aspose.Email sử dụng đối tượng lớp Appointment. Bạn cần có thông tin yêu cầu họp gốc để hủy. Ví dụ trong bài này đầu tiên gửi yêu cầu họp, lưu thông tin vào cơ sở dữ liệu và sau đó hủy yêu cầu dựa trên ID tin nhắn.

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

Trước khi chúng ta có thể hủy yêu cầu họp, chúng ta cần gửi một vài cái:

Đầu tiên tạo một đối tượng kiểu SmtpClient để gửi tin nhắn.
Để thu thập thông tin người tham dự, chúng tôi đã tạo một lưới dữ liệu để người dùng có thể nhập tên và địa chỉ của những người sẽ nhận lời mời.
Sau khi thực hiện vòng lặp for-each trên bộ sưu tập Rows của lưới, lưu toàn bộ thông tin người tham dự vào bộ sưu tập MailAddressCollection.
Tạo một đối tượng của lớp MailMessage và các thuộc tính cần thiết như From, To và Subject.
Tạo một đối tượng kiểu Appointment và cung cấp thông tin địa điểm, thời gian bắt đầu, thời gian kết thúc, người tổ chức và người tham dự.
Lưu toàn bộ thông tin vào cơ sở dữ liệu SQL Server. Công việc liên quan đến DB được thực hiện trong phương thức SaveIntoDB.

Đoạn mã sau cho bạn cách gửi yêu cầu họp.

Hủy Yêu cầu Họp

Để hủy yêu cầu họp, trước tiên lấy ID của tin nhắn email. Vì chúng tôi đã lưu thông tin này trong cơ sở dữ liệu cho ví dụ này, nên có thể dễ dàng lấy lại. Chúng tôi đã sử dụng một lưới để tải tất cả các tin nhắn đã gửi. Ảnh chụp màn hình của biểu mẫu như dưới đây:

Chọn hàng để gửi yêu cầu hủy.
Nhấn Send Cancel Request để gửi yêu cầu.
Mã lấy ID từ hàng được chọn trong lưới và truy vấn cơ sở dữ liệu để lấy thông tin người tham dự, tin nhắn và lịch liên quan.
Tạo một thể hiện của lớp Calendar và MailMessage các lớp class sử dụng thông tin được lấy từ cơ sở dữ liệu.
Sử dụng phương thức Appointment.CancelAppointment() để gửi yêu cầu hủy.
Gửi email bằng cách sử dụng SMTP.

Đoạn mã sau cho bạn cách hủy yêu cầu họp.

Net: Ứng dụng đầu tiên với Aspose.Email.Outlook

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

Phần này trình bày cách sử dụng Aspose.Email.Mapi. Chúng tôi tạo một ứng dụng nhỏ tải tệp tin tin nhắn Outlook (TestMessage.msg) và hiển thị tiêu đề, địa chỉ người gửi và người nhận, cùng nội dung trên một form Windows. Thực hiện các bước sau để tạo ứng dụng đầu tiên của bạn bằng Aspose.Email.Outlook.

Trong Visual Studio, trên menu File, chọn New, rồi Project.
Chọn tạo ứng dụng Windows bằng C# hoặc VB.NET.
Nhập thư viện Aspose.Email DLL vào ứng dụng bằng cách nhấp chuột phải vào Reference trong Solution Explorer. Đây sẽ là một ứng dụng dựa trên Windows chỉ hiển thị thông tin chứa trong tệp tin tin nhắn.
Tạo một đối tượng của MapiMessage lớp bằng cách cung cấp đường dẫn tới tệp tin tin nhắn.
Sử dụng các thuộc tính công khai để hiển thị tiêu đề, người gửi, người nhận và nội dung trên các điều khiển Windows.

Việc thực hiện các bước trên được minh họa dưới đây trong đoạn mã sau. Sử dụng đoạn mã sau phía sau nút Load Msg File hoặc trong sự kiện OnLoad của form.

Net: Kết nối Pool Được Tái cấu trúc

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

Với việc phát hành Aspose.Email 19.3, pool kết nối đã được tái cấu trúc. Mới EmailClient lớp đã được giới thiệu sẽ cuối cùng thay thế CredentialsByHostClient lớp. EmailClient lớp cung cấp một ConnectionAsgmtMode thuộc tính xác định chế độ cấp phát kết nối trong môi trường đa luồng. EmailClient.ConnectionAsgmtMode được đặt bằng cách sử dụng ConnectionAsgmtType enumerable.

Các loại kết nối

Có ba loại kết nối sau:

The main connection: This is the connection created and disposed together with the mail client. It can’t be created or disposed manually.
Default connection: User can create default connections for threads with CreateConnection phương thức. Nếu kết nối mặc định tồn tại, tất cả các phương thức của client email thực thi trong một luồng sẽ ngầm sử dụng kết nối này. Chỉ một kết nối mặc định có thể tồn tại cho mỗi luồng. Nó có thể được tạo thủ công hoặc tự động. Điều này phụ thuộc vào thuộc tính EmailClient.ConnectionAsgmtMode. Các kết nối này có thể được tạo thủ công với EmailClient.CreateConnection(createAsDefaultConnection = true) phương thức. Nếu kết nối mặc định không được sử dụng (phụ thuộc vào chế độ cấp phát kết nối), kết nối chính sẽ được sử dụng ngầm thay thế cho nó.
Independent connections: These are connections that are not linked to threads. They can be created manually and have to be used explicitly as a method parameter. These connections can be created manually with EmailClient.CreateConnection() phương thức hoặc EmailClient.CreateConnection(createAsDefaultConnection = false) phương thức.

Các loại cấp phát kết nối

Để thiết lập EmailClient.ConnectionAsgmtMode thuộc tính, ConnectionAsgmtType enumerable được sử dụng. Các loại cấp phát được cung cấp bởi ConnectionAsgmtType được liệt kê dưới đây.

ConnectionAsgmtType.UseMainOrDefault: Chế độ này được sử dụng mặc định trong các máy khách email. Máy khách email sử dụng kết nối chính cho tất cả các hoạt động từ nhiều luồng nếu kết nối mặc định chưa được tạo, hoặc nếu không có kết nối nào được truyền vào tham số phương thức một cách rõ ràng. Kết nối chính là một kết nối được tạo đồng thời với máy khách email. Người dùng có thể tạo kết nối mặc định cho các luồng với CreateConnection phương thức. Nếu kết nối mặc định cho một luồng được tạo, nó sẽ được sử dụng ngầm cho tất cả các phương thức của client email được gọi trong luồng này. Nếu kết nối mặc định cho một luồng không được tạo, kết nối chính được sử dụng cho tất cả các phương thức của client email được gọi trong luồng này. Người dùng cũng có thể tạo các kết nối không liên kết với luồng (không phải kết nối mặc định) bằng CreateConnection phương thức. Nếu người dùng muốn sử dụng các kết nối khác (không phải chính và không phải mặc định) họ phải truyền kết nối này một cách rõ ràng như tham số của phương thức mà họ muốn sử dụng. Người dùng có thể tạo thêm bất kỳ số lượng kết nối nào. Kết nối mặc định có thể chỉ một cho mỗi luồng. Lưu ý rằng các kết nối mặc định hoạt động chính xác nếu người dùng sử dụng các đối tượng Thread cho lập trình đa nhiệm. Nếu người dùng sử dụng ConnectionPool hoặc các đối tượng Task cho lập trình đa nhiệm, chế độ này có thể dẫn đến hành vi sai của ứng dụng. Để tránh vấn đề này, người dùng phải tự tay giải phóng kết nối mặc định (nếu họ sử dụng nó) vào cuối quá trình thực thi mã.
ConnectionAsgmtType.UseMain: Máy khách email sử dụng kết nối chính cho tất cả các hoạt động từ nhiều luồng. Kết nối chính là một kết nối được tạo đồng thời với máy khách email. Người dùng không thể tạo kết nối mặc định. Người dùng có thể tạo các kết nối không gắn với luồng (không phải kết nối mặc định) bằng CreateConnection phương thức. Nếu người dùng muốn sử dụng các kết nối khác (không phải chính và không phải mặc định) họ phải truyền kết nối này một cách rõ ràng như tham số của phương thức mà họ muốn sử dụng.
ConnectionAsgmtType.UseDefault: Máy khách email ngầm sử dụng chỉ các kết nối mặc định cho tất cả các hoạt động từ nhiều luồng. Kết nối chính không được sử dụng trong chế độ này. Nếu kết nối mặc định chưa được tạo cho một số luồng (lần gọi phương thức máy khách email đầu tiên), máy khách email sẽ tạo kết nối mặc định một cách ngầm cho luồng đó trước khi thực hiện thao tác đầu tiên. Người dùng không thể tạo kết nối mặc định cho các luồng với CreateConnectionphương thức vì chúng được tạo tự động. Khi kết nối mặc định cho một luồng được tạo, nó sẽ được sử dụng ngầm cho tất cả các phương thức của client email được gọi trong luồng này. Người dùng cũng có thể tạo các kết nối không liên kết với luồng (không phải kết nối mặc định) bằng CreateConnectionphương thức. Nếu người dùng muốn sử dụng các kết nối khác (không phải chính và không phải mặc định) họ phải truyền kết nối này một cách rõ ràng như tham số của phương thức mà họ muốn sử dụng. Người dùng có thể tạo thêm bất kỳ số lượng kết nối nào. Chỉ một kết nối mặc định có thể được sử dụng cho mỗi luồng. Lưu ý rằng các kết nối mặc định hoạt động chính xác nếu người dùng sử dụng các đối tượng Thread cho lập trình đa nhiệm. Nếu người dùng sử dụng ConnectionPool hoặc các đối tượng Task cho lập trình đa nhiệm, chế độ này có thể dẫn đến hành vi sai của ứng dụng. Để tránh vấn đề này, người dùng phải tự tay giải phóng kết nối mặc định vào cuối quá trình thực thi mã.