Documentation – Làm việc với các mục Outlook

Net: Tạo và Lưu Tập tin Outlook

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

Aspose.Email hỗ trợ tạo các tệp Outlook message (MSG). Bài viết này giải thích cách:

Tạo và Lưu Tin nhắn Outlook

Cái MailMessage lớp có Save() phương thức có thể lưu các tệp Outlook MSG vào đĩa hoặc stream. Các đoạn mã dưới đây tạo một thể hiện của MailMessage lớp, thiết lập các thuộc tính như from, to, subject và body. Phương thức Save() phương thức nhận tên tệp làm đối số. Ngoài ra, các Tin nhắn Outlook có thể được tạo với một phần thân RTF nén sử dụng MapiConversionOptions.

Tạo một thể hiện mới của MailMessage lớp và thiết lập các thuộc tính From, To, Subject và Body.
Gọi MapiMessage lớp FromMailMessage phương thức nhận đối tượng của MailMessage kiểu. Phương thức FromMailMessage phương thức chuyển đổi MailMessage vào một MapiMessage (MSG).
Gọi MapiMessage.Save() phương thức để lưu tệp MSG.

Viết đoạn mã sau trong sự kiện click của nút điều khiển trong ứng dụng Windows.

Tạo Tệp MSG với Đính kèm

Trong ví dụ trên, chúng tôi đã tạo một tệp MSG đơn giản. Aspose.Email cũng hỗ trợ lưu các tệp tin nhắn kèm đính kèm. Tất cả những gì bạn cần làm là thêm các đính kèm vào MailMessage đối tượng. Thêm đính kèm bằng cách gọi phương thức Add() trên MailMessage.Attachments bộ sưu tập. Thêm một listbox vào form tạo ở trên và thêm hai nút, một cho việc thêm và một cho việc xóa đính kèm. Ứng dụng thêm các ứng dụng hoạt động như sau:

Khi nút Add Attachment được nhấn, một Open File Dialog sẽ được hiển thị để giúp người dùng duyệt và chọn tệp đính kèm.
Khi một tệp đã được chọn, đường dẫn đầy đủ sẽ được thêm vào danh sách.
Khi tệp MSG được tạo, các đường dẫn đính kèm được lấy từ danh sách và thêm vào MailMessage.Attachments bộ sưu tập.

Viết đoạn mã sau trong sự kiện nhấp nút Add Attachment.

Khi nút Remove Attachment được nhấn, xóa các mục đã chọn khỏi listbox. Viết đoạn mã sau trong sự kiện nhấp nút Remove Attachment.

Thêm mã cho việc thêm đính kèm vào MailMessage đối tượng. Mã cuối cùng cho hàm Write Msg được viết như dưới đây.

Tạo Tệp MSG với Nội dung RTF

Bạn cũng có thể tạo các tệp Outlook Message (MSG) với phần thân văn bản định dạng (RTF) bằng Aspose.Email. Phần thân RTF hỗ trợ định dạng văn bản. Tạo một bằng cách thiết lập MailMessage.HtmlBody thuộc tính. Khi bạn chuyển đổi một MailMessage đối tượng thành một MapiMessage trong trường hợp này, phần thân HTML được chuyển thành RTF. Cách này giúp định dạng của phần thân email được bảo tồn.

Ví dụ sau tạo một tệp MSG với phần thân RTF. Có một tiêu đề, định dạng in đậm và gạch dưới được áp dụng trong phần thân HTML. Định dạng này được giữ lại khi HTML được chuyển sang RTF.

Nén RTF cho Phần Thân Tin Nhắn MAPI

NOTE: Quá trình nén có thể làm chậm hiệu suất khi tạo tin nhắn. Bằng cách hiểu thực tế này và cấu hình cờ nén dựa trên các yêu cầu cụ thể và sự cân bằng giữa kích thước tệp và hiệu suất, các nhà phát triển có thể quản lý hiệu quả việc tạo các tệp MSG và PST khi xử lý tin nhắn email.

Nén RTF nhằm giảm kích thước của một tin nhắn cũng như các tệp PST (Personal Storage Table) kết quả mà Microsoft Outlook sử dụng để lưu trữ tin nhắn email và các dữ liệu khác. Bằng cách sử dụng nén RTF khi cấu hình phần thân tin nhắn, các nhà phát triển có thể giảm lượng bộ nhớ cần thiết để lưu trữ tin nhắn email hoặc tối ưu băng thông mạng khi truyền tin nhắn.

Vì mục đích này, đã được thiết kế hai phương thức quá tải:

MapiMessageItemBase.SetBodyContent(string content, BodyContentType contentType, bool compression): Phương thức này cho phép bạn đặt nội dung thân tin nhắn bằng chuỗi nội dung đã chỉ định và xác định loại nội dung thân (ví dụ: văn bản thuần, HTML, v.v.). Tham số compression tùy chọn là một giá trị chỉ định liệu nội dung có nên được nén bằng nén RTF hay không. Nếu tham số compression là true, nội dung sẽ được nén, dẫn đến kích thước tin nhắn nhỏ hơn.
MapiMessageItemBase.SetBodyRtf(string content, bool compression): Phương thức này đặc biệt đặt nội dung của thân tin nhắn ở định dạng RTF. Tham số content là một chuỗi đại diện cho nội dung RTF sẽ được đặt làm thân tin nhắn. Giống như phương thức trước, tham số compression quyết định liệu có áp dụng nén RTF cho nội dung hay không. Nếu compression là true, nội dung RTF sẽ được nén để giảm kích thước.

Mẫu mã sau đây cho thấy cách đặt thân html và giữ nó được nén:

var msg = new MapiMessage("from@doamin.com", "to@domain.com", "subject", "body");
// set the html body and keep it compressed
// this will reduce the message size
msg.SetBodyContent(htmlBody, BodyContentType.Html, true);

Cũng có một MapiConversionOptions.UseBodyCompression thuộc tính. Khi thuộc tính này được bật, nén thân RTF sẽ được áp dụng trong quá trình chuyển đổi MailMessage sang MapiMessage, dẫn đến kích thước tệp MSG nhỏ hơn. Nó được hiển thị trong mẫu mã dưới đây:

var message = MailMessage.Load(fileName);
var options = new MapiConversionOptions();
options.UseBodyCompression = true;
var msg = MapiMessage.FromMailMessage(message, options);

Lưu Tin nhắn ở Trạng thái Bản nháp

Email được lưu dưới dạng bản nháp khi người dùng đã bắt đầu chỉnh sửa nhưng muốn quay lại để hoàn thành sau. Aspose.Email hỗ trợ lưu tin nhắn email ở trạng thái bản nháp bằng cách thiết lập cờ tin nhắn. Dưới đây là đoạn mã mẫu để lưu một tin nhắn email Outlook (MSG) dưới dạng bản nháp.

Net: Tải và Phân tích Tệp MSG

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

Sử dụng Aspose.Email cho .NET, các nhà phát triển có thể tải và phân tích nội dung từ các tệp tin nhắn Outlook.

Để tải các tệp MSG từ đĩa, sử dụng tĩnh MapiMessage.Load phương thức của MapiMessage lớp. Lớp này cung cấp một số hàm tải tĩnh cho các kịch bản khác nhau.
Để phân tích nội dung tệp MSG, MapiMessage phơi bày một số phương thức và thuộc tính.

Trong bài viết này, bạn sẽ học cách tải và phân tích một tệp MSG để hiển thị nội dung của nó. Các mẫu mã kèm hướng dẫn sẽ giúp bạn hiểu rõ cách triển khai chức năng tải và phân tích các tệp MSG của Outlook trong dự án của mình.

Đầu tiên, học cách tải các tệp MSG từ tệp hoặc từ luồng.

Tải Các Tệp MSG

Đoạn mã sau đây cho bạn thấy cách tải các tệp MSG.

// Create an instance of MapiMessage from file
var msg = MapiMessage.Load(@"message.msg");

// Get subject
Console.WriteLine("Subject:" + msg.Subject);

// Get from address
Console.WriteLine("From:" + msg.SenderEmailAddress);

// Get body
Console.WriteLine("Body" + msg.Body);

// Get recipients information
Console.WriteLine("Recipient: " + msg.Recipients);

// Get attachments
foreach (var att in msg.Attachments)
{
    Console.Write("Attachment Name: " + att.FileName);
    Console.Write("Attachment Display Name: " + att.DisplayName);
}

Ví dụ mã dưới đây cho thấy cách sử dụng MailMessage để tải một tin nhắn ở định dạng MSG.


var eml = MailMessage.Load("message.msg");

Cần lưu ý rằng tin nhắn đầu ra sẽ được chuyển đổi sang định dạng EML, bao gồm các tệp đính kèm tin nhắn nhúng. Không sử dụng phương pháp tải này nếu bạn muốn giữ một số thuộc tính định dạng msg cụ thể của tin nhắn gốc.

Để giữ nguyên định dạng gốc của các tệp đính kèm tin nhắn nhúng, sử dụng msgLoadOptions.PreserveEmbeddedMessageFormat thuộc tính.


var msgLoadOptions = new MsgLoadOptions();
msgLoadOptions.PreserveEmbeddedMessageFormat = true;
var msg = MailMessage.Load(stream, msgLoadOptions);

Tải từ Luồng

Đoạn mã sau cho bạn thấy cách tải tệp từ luồng.

// Create an instance of MapiMessage from file
byte[] bytes = File.ReadAllBytes(@"message.msg");

using (MemoryStream stream = new MemoryStream(bytes))
{
    stream.Seek(0, SeekOrigin.Begin);
    // Create an instance of MapiMessage from file
    MapiMessage msg = MapiMessage.Load(stream);

    // Get subject
    Console.WriteLine("Subject:" + msg.Subject);

    // Get from address
    Console.WriteLine("From:" + msg.SenderEmailAddress);

    // Get body
    Console.WriteLine("Body" + msg.Body);

}

Chuyển Đổi EML sang MSG Khi Bảo Vệ Định Dạng EML Nhúng

Các tệp EML có thể được tải vào MapiMessage lớp bằng cách khởi tạo một MailMessage đối tượng và truyền nó tới MapiMessage.FromMailMessage phương thức. Nếu tệp EML chứa các tệp EML nhúng, hãy sử dụng MapiConversionOptions.PreserveEmbeddedMessageFormat để giữ nguyên định dạng của các tệp EML nhúng. Đoạn mã dưới đây cho thấy cách tải các tệp EML vào MapiMessage trong khi giữ nguyên định dạng của các tệp EML nhúng.

// Load the EML file into a MailMessage object
var mailMessage = MailMessage.Load(emlFilePath);

// Set conversion options to preserve the format of embedded EML messages
var options = new MapiConversionOptions
    {
        PreserveEmbeddedMessageFormat = true
    };

// Convert MailMessage to MapiMessage, preserving embedded EML files
var mapiMessage = MapiMessage.FromMailMessage(mailMessage, options);

// Save the converted message in MSG format
mapiMessage.Save(msgFilePath);

Try it out!

Chuyển đổi email & lưu trữ tin nhắn trực tuyến với phiên bản miễn phí Ứng dụng Chuyển đổi Aspose.Email.

Phân Tích Các Tệp Tin Nhắn Outlook

Aspose.Email cho .NET cung cấp MapiMessage lớp được sử dụng để mở và phân tích tệp MSG. Vì có thể có nhiều người nhận trong một tệp MSG, thì MapiMessage lớp này cung cấp Người Nhận thuộc tính trả về một MapiRecipientCollection mà đại diện cho một bộ sưu tập của MapiRecipient các đối tượng. Các MapiRecipient đối tượng này còn phơi bày các phương thức để làm việc với thuộc tính người nhận.

Chuỗi các bước sau thực hiện mục đích này:

Tạo một đối tượng của MapiMessage lớp sử dụng MapiMessage.Load phương thức tĩnh.
Hiển thị tên người gửi, tiêu đề và nội dung từ tệp MSG bằng cách sử dụng SenderName, Tiêu đề và Nội dung các thuộc tính.
Sử dụng Người Nhận thuộc tính để lấy tham chiếu đến bộ sưu tập của MapiRecipient đối tượng liên quan đến tệp MSG.
Lặp qua MapiRecipientCollection bộ sưu tập để hiển thị nội dung cho mỗi MapiRecipient đối tượng thông qua các phương thức công khai của nó.

//Instantiate an MSG file to load an MSG file from disk
var outlookMessageFile = MapiMessage.Load(dataDir + "message.msg");
//Display sender's name
Console.WriteLine("Sender Name : " + outlookMessageFile.SenderName);
//Display Subject
Console.WriteLine("Subject : " + outlookMessageFile.Subject);
//Display Body
Console.WriteLine("Body : " + outlookMessageFile.Body);
//Display Recipient's info
Console.WriteLine("Recipients : \n");

//Loop through the recipients collection associated with the MapiMessage object
foreach (var rcp in outlookMessageFile.Recipients)
{
	//Display recipient email address
	Console.WriteLine("Email : " + rcp.EmailAddress);
	//Display recipient name
	Console.WriteLine("Name : " + rcp.DisplayName);
	//Display recipient type
	Console.WriteLine("Recipient Type : " + rcp.RecipientType);
}

Try it out!

Phân tích tệp email trực tuyến miễn phí Ứng dụng Phân tích Aspose.Email.

Net: Quản lý Tin nhắn Outlook

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

Lưu Email dưới Dạng HTML

Aspose.Email cho phép lưu tài nguyên email với đường dẫn tương đối khi xuất tin nhắn sang định dạng HTML. Tính năng này cung cấp độ linh hoạt cao hơn trong cách liên kết tài nguyên trong tệp HTML đầu ra, giúp dễ dàng chia sẻ và hiển thị email đã lưu trên các hệ thống khác nhau. Để lưu tài nguyên với đường dẫn tương đối, sử dụng HtmlSaveOptions.UseRelativePathToResources thuộc tính. Giá trị mặc định của thuộc tính là false (tài nguyên được lưu với đường dẫn tuyệt đối). Khi đặt thành true, tài nguyên được lưu với đường dẫn tương đối.

Các tệp HTML có đường dẫn tương đối dễ di chuyển hơn và có thể được xem đúng cách bất kể cấu trúc thư mục của môi trường lưu trữ. Bạn có thể lựa chọn giữa đường dẫn tuyệt đối và tương đối tùy theo yêu cầu. Bạn có thể định nghĩa các đường dẫn tùy chỉnh cho tài nguyên bằng cách sử dụng ResourceHtmlRendering sự kiện.

Đoạn mã sau trình bày cách lưu email với đường dẫn tương đối mặc định tới tài nguyên:

var msg = MapiMessage.Load(sourceFileName);

var htmlSaveOptions = new HtmlSaveOptions
{
    ResourceRenderingMode = ResourceRenderingMode.SaveToFile,
    UseRelativePathToResources = true
};

msg.Save(Path.Combine("target_files"), htmlSaveOptions);

Trong trường hợp này, các tài nguyên sẽ được lưu trong thư mục [html file name]_files, cùng đường dẫn với tệp .html và HTML sẽ tham chiếu các tài nguyên qua các đường dẫn tương đối.

Mẫu mã dưới đây trình bày cách lưu với đường dẫn tuyệt đối tới tài nguyên:

var msg = MapiMessage.Load(sourceFileName);

var htmlSaveOptions = new HtmlSaveOptions
{
    ResourceRenderingMode = ResourceRenderingMode.SaveToFile,
    UseRelativePathToResources = false
};

msg.Save(Path.Combine("target_files"), htmlSaveOptions);

Giống như trong trường hợp đầu tiên, các tài nguyên sẽ được lưu trong thư mục [html file name]_files theo mặc định, nhưng HTML sẽ tham chiếu tài nguyên bằng các đường dẫn tuyệt đối.

Bằng cách sử dụng ResourceHtmlRendering sự kiện, bạn có thể đặt đường dẫn tài nguyên tùy chỉnh dưới dạng tương đối hoặc tuyệt đối. Khi tùy chỉnh đường dẫn với ResourceHtmlRendering trình xử lý sự kiện, và vì UseRelativePathToResources được đặt thành true, bạn nên gán một đường dẫn tương đối tới PathToResourceFile thuộc tính để đảm bảo tham chiếu đúng.

Đoạn mã sau trình bày cách tùy chỉnh đường dẫn tương đối bằng sự kiện ResourceHtmlRendering

var msg = MapiMessage.Load(sourceFileName);

var htmlSaveOptions = new HtmlSaveOptions
{
    ResourceRenderingMode = ResourceRenderingMode.SaveToFile,
    UseRelativePathToResources = true
};

htmlSaveOptions.ResourceHtmlRendering += (o, args) =>
{
    if (o is AttachmentBase attachment)
    {
	    // Since UseRelativePathToResources = true, you should assign a relative path to the PathToResourceFile property.
        args.PathToResourceFile = $@"images\{attachment.ContentType.Name}";
    }
};

msg.Save(Path.Combine(targetPath, "A Day in the Park.html"), htmlSaveOptions);

Chuyển Đổi MSG sang Thông Điệp MIME

Aspose.Email API cung cấp khả năng chuyển đổi tệp MSG sang tin MIME bằng cách sử dụng ToMailMessage phương thức.

Đặt Thời Gian Chờ cho Việc Chuyển Đổi và Tải Tin Nhắn

Các tính năng sau sẽ cho phép bạn đặt thời gian chờ bằng milisecond cho quá trình chuyển đổi và tải:

MailConversionOptions.Timeout thuộc tính - Giới hạn thời gian bằng miliseconds khi chuyển đổi một tin nhắn.
MailConversionOptions.TimeoutReached - Bị ném ra nếu thời gian hết hạn trong khi chuyển đổi sang MailMessage.
MsgLoadOptions.Timeout - Giới hạn thời gian tính bằng mili giây khi chuyển đổi một tin nhắn.
MsgLoadOptions.TimeoutReached - Bị ném ra nếu thời gian hết hạn trong khi chuyển đổi sang MailMessage.

Mẫu mã dưới đây sẽ cho bạn thấy cách đặt thời gian chờ khi chuyển đổi tin nhắn:

var options = new MailConversionOptions();
// Set the timeout to 5 seconds
options.Timeout = 5000;

options.TimeoutReached += (object sender, EventArgs args) =>
{
    string subj = (sender as MailMessage).Subject;
	 // Set a flag indicating the timeout was reached
    isTimedOut = true;
};

var mailMessage = mapiMessage.ToMailMessage(options);

Chuyển Đổi MSG sang EML Giữ Phần Thân RTF

Việc chuyển đổi tệp MSG sang EML giữ nguyên phần thân RTF có thể thực hiện bằng hai cách:

sử dụng MsgLoadOptions.PreserveRtfContent thuộc tính của MsgLoadOptions class;
sử dụng MailConversionOptions.PreserveRtfContent thuộc tính của MailConversionOptions class;

Cả hai thuộc tính đều lấy hoặc đặt giá trị chỉ ra có nên giữ phần thân rtf trong MailMessage hay không.

Các đoạn mã sau đây cho thấy cách chuyển đổi tệp MSG sang EML và giữ nguyên phần thân RTF:

var loadOptions = new MsgLoadOptions
{
    PreserveRtfContent = true
};

var eml = MailMessage.Load("my.msg", loadOptions);

var conversionOptions = new MailConversionOptions
{
    PreserveRtfContent = true
};

var msg = MapiMessage.Load("my.msg");

var eml = msg.ToMailMessage(conversionOptions);

Xử Lý Tệp Mẫu Outlook (.OFT)

Mẫu Outlook rất hữu ích khi bạn muốn gửi lại cùng một email nhiều lần. Thay vì chuẩn bị tin nhắn từ đầu mỗi lần, trước tiên, chuẩn bị tin nhắn trong Outlook và lưu nó dưới dạng Mẫu Outlook (OFT). Sau đó, bất cứ khi nào bạn cần gửi tin nhắn, bạn có thể tạo nó từ mẫu, tiết kiệm thời gian viết lại cùng nội dung trong phần thân hoặc tiêu đề, thiết lập định dạng và vân vân. Aspose.Email’s MailMessage lớp có thể được sử dụng để tải và đọc tệp mẫu Outlook (OFT). Khi mẫu Outlook đã được tải trong một thể hiện của MailMessage lớp, bạn có thể cập nhật người gửi, người nhận, nội dung, tiêu đề và các thuộc tính khác. Sau khi cập nhật các thuộc tính:

Gửi email bằng cách sử dụng SmtpClient lớp hoặc
Lưu tin nhắn dưới dạng MSG và thực hiện các cập nhật/kiểm tra tiếp theo bằng Microsoft Outlook.

Trong các mẫu mã dưới đây, chúng tôi:

Tải mẫu bằng cách sử dụng MailMessage lớp.
Cập nhật một số thuộc tính.
Lưu tin nhắn ở định dạng MSG.

Đoạn mã sau cho bạn thấy cách tải tệp OFT, cập nhật tin nhắn và lưu nó ở định dạng MSG.

Lưu Tệp MSG dưới Dạng Mẫu

Đoạn mã dưới đây cho bạn thấy cách lưu tệp MSG outlook dưới dạng mẫu.

Xác định Loại Tin nhắn MAPI (OFT hoặc MSG)

Khi tải đối tượng MapiMessage từ tệp, bạn có thể cần xác định xem tin nhắn đã tải là tệp mẫu hay tệp email thông thường. Bằng cách sử dụng IsTemplate thuộc tính của MapiMessage lớp, bạn có thể phát hiện chính xác xem một email có phải là mẫu hay không. Chức năng này có thể có giá trị khi xử lý và xử lý các loại tệp email khác nhau trong ứng dụng và hệ thống.

Ví dụ mã dưới đây minh họa cách xác định một MapiMessage là OFT hay MSG:

var msg = MapiMessage.Load("message.msg");
var isOft = msg.IsTemplate; // returns false

var msg = MapiMessage.Load("message.oft");
var isOft = msg.IsTemplate; // returns true

Lưu MapiMessage hoặc MailMessage ở Định dạng OFT

Cái SaveOptions lớp cho phép bạn chỉ định các tùy chọn bổ sung khi lưu MailMessage hoặc MapiMessage vào một định dạng cụ thể.

Đoạn mã mẫu dưới đây minh họa cách lưu một tin nhắn dưới định dạng OFT:

// Save the MailMessage to OFT format
using (var eml = MailMessage.Load("message.eml"))
{
    eml.Save("message.oft", SaveOptions.DefaultOft);
	
	// or alternative way #2
	var saveOptions = new MsgSaveOptions(MailMessageSaveType.OutlookTemplateFormat);
    eml.Save("message.oft", saveOptions);
	
	// or alternative  way #3
	saveOptions = SaveOptions.CreateSaveOptions(MailMessageSaveType.OutlookTemplateFormat);
    eml.Save("message.oft", saveOptions);

}

// Save the MapiMessage to OFT format
using (var msg = MapiMessage.Load("message.msg"))
{
    msg.Save("message.oft", SaveOptions.DefaultOft);
	
	// or alternative way #2
	var saveOptions = new MsgSaveOptions(MailMessageSaveType.OutlookTemplateFormat);
    msg.Save("message.oft", saveOptions);
	
	// or alternative  way #3
	saveOptions = SaveOptions.CreateSaveOptions(MailMessageSaveType.OutlookTemplateFormat);
    msg.Save("message.oft", saveOptions);
}

Quản lý Tin nhắn Được ký số

Aspose.Email thực hiện đầy đủ thuật toán đối tượng email S/MIME. Điều này cung cấp cho API khả năng hoàn chỉnh để bảo lưu chữ ký số khi chuyển đổi tin nhắn giữa các định dạng.

Bảo Vệ Chữ Ký trong Khi Chuyển Đổi EML sang MSG

Aspose.Email giữ lại chữ ký số khi chuyển đổi từ EML sang MSG. Đoạn mã dưới đây cho bạn thấy cách chuyển đổi từ EML sang MSG.

Chuyển đổi tin nhắn S/MIME từ MSG sang EML

Aspose.Email giữ lại chữ ký số khi chuyển đổi từ MSG sang EML như trong đoạn mã dưới đây.

Kiểm tra Chữ ký của Email Bảo mật

Các tính năng sau có sẵn để kiểm tra chữ ký của các đối tượng MapiMessage.

SecureEmailManager lớp để kiểm tra chữ ký của email bảo mật.
SmimeResult lớp để lưu trữ kết quả của việc kiểm tra.
SecureEmailManager.CheckSignature(MapiMessage msg) phương thức.
SecureEmailManager.CheckSignature(MapiMessage msg, X509Certificate2 certificateForDecrypt) phương thức.
SecureEmailManager.CheckSignature(MapiMessage msg, X509Certificate2 certificateForDecrypt, X509Store store) phương thức.

Đoạn mã mẫu dưới đây cho thấy cách triển khai các tính năng trong dự án của bạn:

var msg = MapiMessage.Load(fileName, new EmlLoadOptions());
var result = new SecureEmailManager().CheckSignature(msg);

var certFileName = "cert.pfx";
var cert = new X509Certificate2(certFileName, "pass");
var eml = MapiMessage.Load(fileName);
var store = new X509Store();
store.Open(OpenFlags.ReadWrite);
store.Add(cert);
store.Close();

var result = new SecureEmailManager().CheckSignature(eml, cert, store);

Xóa Chữ ký khỏi MapiMessages

Để tăng khả năng tương thích, MapiMessage.RemoveSignature phương thức và MapiMessage.IsSigned thuộc tính được sử dụng để loại bỏ chữ ký số khỏi một tin nhắn.

Đoạn mã sau đây cho thấy cách triển khai các tính năng này vào dự án của bạn:

var msg = MapiMessage.Load(fileName);

if (msg.IsSigned)
{
    var unsignedMsg = msg.RemoveSignature();
}

Giải mã MapiMessages bằng Chứng chỉ

Nếu bạn có các tin nhắn MAPI được mã hoá và cần giải mã chúng bằng khóa riêng lưu trong chứng chỉ, các tính năng sau của Aspose.Email có thể hữu ích:

MapiMessage.IsEncrypted - Lấy giá trị cho biết liệu tin nhắn có được mã hóa hay không.
MapiMessage.Decrypt() - Giải mã tin nhắn này (phương thức tìm kiếm trong kho lưu trữ My của người dùng và máy tính hiện tại để tìm chứng chỉ và khóa riêng phù hợp).
MapiMessage.Decrypt(X509Certificate2 certificate) - Giải mã tin nhắn này bằng chứng chỉ.

Đoạn mã dưới đây cho thấy cách làm việc với các tin nhắn MAPI được mã hoá:

var privateCert = new X509Certificate2(privateCertFile, "password");
var msg = MapiMessage.Load("encrypted.msg");

if (msg.IsEncrypted);
{
    var decryptedMsg = msg.Decrypt(privateCert);
}

Đặt Các Danh mục Màu cho Tệp MSG

Một danh mục màu đánh dấu một tin email với một mức độ quan trọng hoặc loại nào đó. Microsoft Outlook cho phép người dùng gán các danh mục màu để phân biệt email. Để xử lý danh mục màu, sử dụng FollowUpManager. Nó chứa các hàm như AddCategory, RemoveCategory, ClearCategories và GetCategories.

AddCategory nhận MapiMessage và chuỗi danh mục màu, ví dụ "Purple Category" hoặc "Red Category" làm đối số.
RemoveCategory nhận MapiMessage và chuỗi danh mục màu cần xóa khỏi tin nhắn.
ClearCategories được sử dụng để xóa tất cả các danh mục màu khỏi tin nhắn.
GetCategories được sử dụng để lấy tất cả các danh mục màu từ một tin nhắn cụ thể.

Ví dụ dưới đây thực hiện các công việc như sau:

Thêm một danh mục màu.
Thêm một danh mục màu khác.
Lấy danh sách tất cả các danh mục.
Xóa tất cả các danh mục.

Truy cập Thông tin Theo dõi trong Tệp MSG

Aspose.Email API cung cấp khả năng truy cập thông tin theo dõi từ một tin nhắn đã gửi hoặc đã nhận. Nó có thể lấy thông tin Đã Đọc, Biên Nhận Đã Giao và kết quả bỏ phiếu từ tệp tin tin nhắn.

Truy xuất Thông tin Nhận đọc và Bản kê Giao nhận

Đoạn mã dưới đây cho bạn thấy cách lấy thông tin biên nhận đã đọc và đã giao.

Tạo Tin nhắn Chuyển tiếp và Trả lời

API Aspose.Email cung cấp khả năng tạo và định dạng các tin nhắn chuyển tiếp và trả lời. ReplyMessageBuilder và ForwardMessageBuilder các lớp của API được sử dụng để tạo tin nhắn Reply và Forward tương ứng. Một tin nhắn Reply hoặc Forward có thể được chỉ định tạo bằng bất kỳ chế độ nào của OriginalMessageAdditionMode enum. Enum này có các giá trị sau:

OriginalMessageAdditionMode.None - Tin nhắn gốc không được đưa vào trong tin nhắn trả lời.
OriginalMessageAdditionMode.Attachment - Tin nhắn gốc được đưa vào dưới dạng đính kèm trong tin nhắn trả lời
OriginalMessageAdditionMode.Textpart - Tin nhắn gốc được bao gồm dưới dạng văn bản trong phần thân của tin nhắn phản hồi

Tạo Tin nhắn Trả lời

Đoạn mã sau đây cho bạn thấy cách tạo một tin nhắn trả lời.

Tạo Tin nhắn Chuyển tiếp

Đoạn mã dưới đây cho bạn cách tạo tin nhắn chuyển tiếp.

Net: Sử dụng Điều khiển Aspose Outlook để Kéo và Thả Tin nhắn Outlook vào Windows Forms

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

Aspose.Email hỗ trợ tính năng kéo và thả của Microsoft Outlook. Nó cho phép các nhà phát triển dễ dàng tạo các phần tử UI đáp ứng các sự kiện kéo-thả của Outlook. Mẫu sau đây cho thấy cách tạo một panel mà người dùng có thể kéo tin nhắn từ Outlook và thả vào, và chương trình để lưu tin nhắn thành tệp MSG. Đoạn mã sau đây cho bạn cách thiết lập một điều khiển Aspose Outlook có thể nhận các tin nhắn Outlook được thả.

Tạo một ứng dụng Windows Form.
Thêm tham chiếu tới assembly Aspose.Email.
Duyệt đến tệp Aspose.Email.dll và nhấn OK.

Phần tử UI được tạo trong mẫu này là một panel. Để tạo một panel:

Nhấp chuột phải vào dự án của bạn trong bảng giải pháp và chọn Add rồi New item từ menu.
Tạo một lớp gọi là MyPanel:
Giả sử MyPanel là một lớp con của System.Windows.Form.Panel và thêm thuộc tính Aspose.Email.Windows.Forms.FileDropTargetManager vào MyPanel:

Ghi đè các phương thức OnHandleCreated và OnHandleDestroyed để đăng ký MyPanel bằng Aspose.Email.Windows.Forms.FileDropTargetManager:

Xây dựng dự án.

MyPanel đã sẵn sàng để sử dụng. Panel này chấp nhận các sự kiện kéo và thả từ Outlook.

Mở bảng toolbox và kéo MyPanel vào Windows Form của bạn:

Thêm trình xử lý sự kiện vào sự kiện DragDrop của MyPanel. (Đừng quên đặt thuộc tính AllowDrop thành true từ bảng thuộc tính và thay đổi thuộc tính BackColor của MyPanel thành màu bạn thích.)

Thêm dòng sau vào phương thức InitializeComponent() của Form chính:

Triển khai trình xử lý sự kiện DragDrop để lưu các tin nhắn được kéo từ Outlook thành tệp MSG.
Ép DragEventArgs sang Aspose.Email.Windows.Forms.FileDragEventArgs, trong đó chứa một thuộc tính mảng Files đại diện cho mục tiêu kéo của người dùng.

Nếu người dùng kéo một số tin nhắn từ Outlook và thả lên MyPanel, Files.Count là số lượng tin nhắn, và Files i sẽ lặp qua mỗi tin nhắn.

Chạy dự án và kiểm tra.

Bây giờ bạn có thể kéo tin nhắn từ Outlook và thả vào ứng dụng của mình. Ứng dụng sẽ yêu cầu bạn lưu các tin nhắn đó thành tệp MSG.

Net: Làm việc với Các Tùy Chọn Bình Chọn và Phản Ứng trong MSG

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

Tạo Các Tùy Chọn Bình chọn với MapiMessage

Microsoft Outlook cung cấp tính năng tạo cuộc thăm dò khi soạn email mới, cho phép người dùng đưa vào các tùy chọn bình chọn như Có, Không, Có thể, v.v. Aspose.Email cho phép chức năng tương tự khi tạo một tin nhắn Outlook mới một cách lập trình. The FollowUpOptions class cung cấp VotingButtons thuộc tính có thể được sử dụng để đặt hoặc lấy các tùy chọn bình chọn. MapiMessage đề cập đến một lớp trong không gian tên Aspose.Email đại diện cho một tin nhắn email ở định dạng Messaging Application Programming Interface (MAPI) thường được Microsoft Outlook sử dụng. Bằng cách sử dụng lớp MapiMessage, các nhà phát triển có thể thêm nút thăm dò vào email. Bài viết này cung cấp ví dụ chi tiết về cách tạo một MapiMessage với các tùy chọn bình chọn để tạo một cuộc thăm dò.

Tạo Thăm dò

Đoạn mã mẫu sau đây minh họa cách tạo cuộc thăm dò trong tin nhắn Outlook bằng Aspose.Email. The FollowUpManager class hỗ trợ việc thiết lập các tùy chọn bình chọn.

// Create a MapiMessage with the sender, recipient, subject, and body
var msg = new MapiMessage(
    "from@test.com",
    "to@test.com",
    "Flagged message",
    "Make it nice and short, but descriptive. The description may appear in search engines' search results pages..."
);

// Create FollowUpOptions and set the voting buttons
var options = new FollowUpOptions
{
    VotingButtons = "Yes;No;Maybe;Exactly!"
};

// Apply the follow-up options to the message
FollowUpManager.SetOptions(msg, options);

FollowUpOptions: Cung cấp các thuộc tính để cấu hình các hành động tiếp theo như nút bình chọn.
VotingButtons: Thuộc tính chuỗi trong đó các tùy chọn bình chọn khác nhau được phân tách bằng dấu chấm phẩy.
FollowUpManager.SetOptions: Áp dụng các tùy chọn theo dõi đã chỉ định vào tin nhắn.

Đọc Các Tùy Chọn Bình Chọn

Để lấy các tùy chọn bình chọn từ một MapiMessage, bạn có thể sử dụng GetOptions phương thức. Phương thức này không chỉ lấy các nút bình chọn mà còn có thể cung cấp các tham số bổ sung như danh mục nếu cần.

// Retrieve follow-up options from the message
var options = FollowUpManager.GetOptions(msg);

// Voting buttons are returned as a string with a semicolon separator
string votingButtons = options.VotingButtons;

// Display the voting buttons
Console.WriteLine($"Voting Options: {votingButtons}");

GetOptions: Trích xuất FollowUpOptions đối tượng từ tin nhắn, bao gồm các nút bình chọn và có thể các thuộc tính khác.
VotingButtons: Các tùy chọn được trích xuất dưới dạng chuỗi phân tách bằng dấu chấm phẩy, cho phép dễ dàng hiển thị hoặc thao tác.

Đọc Nút Bình Chọn

Nếu bạn chỉ cần truy cập các nút bình chọn dưới dạng danh sách các chuỗi riêng lẻ, bạn có thể sử dụng GetVotingButtons phương thức, trả về chúng dưới dạng một bộ sưu tập.

// Read only voting buttons as a collection of string values
var votingButtons = FollowUpManager.GetVotingButtons(msg);

// Display each voting button
foreach (var button in votingButtons)
{
    Console.WriteLine($"Voting Button: {button}");
}

GetVotingButtons: Trả về một bộ sưu tập các chuỗi nút bình chọn, giúp tiện lợi khi lặp qua chúng và thực hiện các thao tác như hiển thị hoặc sửa đổi.

Thêm Nút Bình Chọn

Bạn có thể thêm các nút bình chọn bổ sung vào một tin nhắn hiện có bằng cách sử dụng AddVotingButton phương thức. Điều này có thể hữu ích cho việc cập nhật động các tùy chọn bình chọn.

// Add a new voting button to the existing message
FollowUpManager.AddVotingButton(msg, "Indeed!");

AddVotingButton: Thêm một tùy chọn bình chọn mới vào các nút bình chọn hiện có của tin nhắn, cho phép tùy chỉnh động các cuộc thăm dò.

Xóa Nút Bình Chọn

Bạn có thể muốn xóa các nút bình chọn cụ thể hoặc xóa tất cả các nút khỏi một tin nhắn. Đoạn mã dưới đây minh họa cả hai hành động bằng cách sử dụng RemoveVotingButton và ClearVotingButtons các phương thức.

// Delete a specific voting button
FollowUpManager.RemoveVotingButton(msg, "Exactly!");

// Or delete all voting buttons from the MapiMessage
FollowUpManager.ClearVotingButtons(msg);

RemoveVotingButton: Xóa một nút bình chọn cụ thể theo tên.
ClearVotingButtons: Xóa tất cả các nút bình chọn, thực tế đặt lại các tùy chọn bình chọn.

Đọc Kết Quả Bình Chọn

Aspose.Email cũng cho phép đọc kết quả bình chọn từ các người nhận của tin nhắn. Bạn có thể truy cập các thuộc tính như phản hồi và thời gian phản hồi của người nhận.

// Load a MapiMessage from a file
var msg = MapiMessage.Load("sample.msg");

// Iterate through each recipient and display their vote information
foreach (var recipient in msg.Recipients)
{
    Console.WriteLine($"Recipient: {recipient.DisplayName}");

    // Get the recipient's response using the appropriate MapiPropertyTag
    var response = recipient.Properties[MapiPropertyTag.PR_RECIPIENT_AUTORESPONSE_PROP_RESPONSE].GetString();
    Console.WriteLine($"Response: {response}");

    // Get the response time
    var responseTime = recipient.Properties[MapiPropertyTag.PR_RECIPIENT_TRACKSTATUS_TIME].GetDateTime();
    Console.WriteLine($"Response time: {responseTime}\n");
}

MapiRecipient: Đại diện cho một người nhận trong MapiMessage, cho phép truy cập dữ liệu phản hồi cá nhân.
*PR_RECIPIENT_AUTORESPONSE_PROP_RESPONSE: Thẻ thuộc tính lưu trữ phản hồi bình chọn của người nhận.
PR_RECIPIENT_TRACKSTATUS_TIME: Thẻ thuộc tính ghi lại thời gian người nhận phản hồi.

Lấy Thông Tin Phản Ứng từ MSG

Cái GetReactions phương thức của FollowUpManager lớp cho phép bạn truy xuất danh sách phản ứng trên một tin nhắn MAPI, giúp dễ dàng phân tích mức độ tương tác của người dùng. Mẫu mã dưới đây minh họa cách lấy các phản ứng khả dụng cho một tin nhắn xác định, cung cấp cái nhìn về tương tác của người dùng:

// Load the message file
var msg = MapiMessage.Load(fileName);

// Retrieve the list of reactions on the message
var reactions = FollowUpManager.GetReactions(msg);

// Iterate through each reaction and output the details to the console
foreach (var reaction in reactions)
{
    Console.WriteLine($"User: {reaction.Name}, Email: {reaction.Email}, Reaction: {reaction.Type}, Date: {reaction.ReactionDateTime}");
}

Net: Quản lý Theo Dõi và Ngày Hạn cho Tệp MSG Outlook

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

Đặt Cờ Theo Dõi và Ngày Hạn cho Tệp MSG

Cờ theo dõi đánh dấu một email cho một hành động nào đó. Microsoft Outlook cho phép người dùng gắn cờ vào tin nhắn và, trong quá trình thiết lập cờ, chỉ định ngày hạn cho việc theo dõi. Microsoft Outlook gửi lời nhắc tới người nhận để khuyến khích họ theo dõi email. Việc gắn cờ vào email và đặt ngày hạn một cách lập trình cho phép các nhà phát triển phần mềm tự động hoá một số loại email và giúp người nhận nhớ thực hiện hành động. Ví dụ, nó có thể được sử dụng để gửi các tin nhắn hàng tháng cho đội bán hàng để nhắc họ hoàn thành báo cáo; hoặc gửi một tin nhắn tới toàn bộ nhân viên để nhắc họ về cuộc họp công ty. Aspose.Email cho .NET hỗ trợ đặt cờ theo dõi và ngày hạn cho MapiMessage các đối tượng sử dụng FollowUpManager và FollowUpOptions. Có một số biến thể mà cờ theo dõi có thể được đặt trên một tin nhắn. Tất cả chúng được sử dụng trong mẫu mã dưới đây:

Đặt cờ theo dõi cho một tin nhắn
Thêm ngày đến hạn và ngày nhắc nhở vào tin nhắn
Thêm một cờ vào tin nhắn của người nhận.
Đánh dấu là hoàn thành.
Xóa cờ.
Đọc các tùy chọn follow up.

Đặt Cờ Theo Dõi

Đoạn mã dưới đây cho bạn thấy cách đặt cờ follow-up.

Đặt Theo Dõi cho Người Nhận

Đoạn mã dưới đây cho bạn thấy cách đặt follow-up cho người nhận.

Đánh Dấu Cờ Theo Dõi là Đã Hoàn Thành

Đoạn mã dưới đây cho bạn thấy cách đánh dấu cờ follow-up là đã hoàn thành.

Xóa Cờ Theo Dõi

Đoạn mã dưới đây cho bạn thấy cách xóa cờ follow-up.

Đọc Các tùy chọn Cờ Theo dõi

Đoạn mã dưới đây cho bạn thấy cách đọc các tùy chọn cờ follow-up cho một tin nhắn.

Net: Làm việc với các thuộc tính MAPI

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

Truy cập và Đặt Thuộc tính MAPI Outlook

Cái MapiProperty lớp đại diện cho một thuộc tính MAPI, bao gồm:

Tên: một chuỗi đại diện cho thuộc tính tên.
Thẻ: một giá trị kiểu long đại diện cho thẻ thuộc tính.
Dữ liệu: một mảng byte đại diện cho thuộc tính dữ liệu.

Lấy Thuộc tính MAPI bằng Thẻ Thuộc tính

Để lấy các thuộc tính MAPI:

Tạo một thể hiện của MapiMessage bởi tải từ tệp hoặc luồng.
Lấy MapiProperty từ MapiMessage.Properties bởi MapiPropertyTag khóa.

Đoạn mã sau cho bạn thấy cách lấy thuộc tính MAPI bằng thẻ thuộc tính MAPI.

Đặt Thuộc tính MAPI

Đoạn mã dưới đây cho bạn thấy cách đặt các thuộc tính MAPI.

nơi định nghĩa của phương thức convertDateTime như sau:

Thuộc tính Bổ sung

Đoạn mã sau đây cho bạn thấy cách đặt các thuộc tính MAPI bổ sung.

Đọc các Thuộc tính MAPI có tên từ Tệp MSG

Đoạn mã dưới đây cho bạn cách đọc các thuộc tính MAPI có tên từ tệp MSG.

Đọc các Thuộc tính MAPI có tên từ Đính kèm

Aspose.Email cũng cho phép bạn duyệt qua các thuộc tính của một MapiAttachment và tìm kiếm một thuộc tính có tên, theo cách tương tự như ví dụ trên, cho MapiMessage. Đoạn mã dưới đây cho bạn cách tìm kiếm một thuộc tính có tên thông qua bộ sưu tập thuộc tính đính kèm.

Xóa Thuộc tính khỏi MSG và Đính kèm

Đoạn mã dưới đây cho bạn cách loại bỏ các thuộc tính khỏi MSG và đính kèm.

Net: Quản lý Tệp Đính Kèm Tin Nhắn

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

Xử Lý Tệp Đính Kèm trong Outlook

Tạo và Lưu Tệp Tin nhắn Outlook (MSG) giải thích cách tạo và lưu tin nhắn, cũng như cách tạo các tệp MSG có đính kèm. Bài viết này giải thích cách quản lý các tệp đính kèm Microsoft Outlook với Aspose.Email. Các tệp đính kèm từ một tệp tin nhắn được truy cập và lưu vào đĩa bằng cách sử dụng MapiMessage lớp Tệp Đính Kèm thuộc tính. The Tệp Đính Kèm thuộc tính là một tập hợp kiểu MapiAttachmentCollection lớp.

Kiểm Tra Loại Tệp Đính Kèm (Nội Tuyến hoặc Thông Thường)

Các tệp đính kèm nội tuyến và thông thường phục vụ các mục đích khác nhau. Các tệp đính kèm nội tuyến được tích hợp trực quan vào tin nhắn email và thường là hình ảnh hoặc tệp media. Trong khi đó, các tệp đính kèm thông thường là các tệp riêng biệt được đính kèm vào email và có thể bao gồm nhiều loại tệp khác nhau. The MapiAttachment.IsInline thuộc tính của MapiAttachment lớp nhận giá trị cho biết đính kèm là nội tuyến hay thông thường.

Mẫu mã dưới đây trích xuất và hiển thị thông tin về mỗi tệp đính kèm trong MapiMessage đã tải, bao gồm tên hiển thị của chúng và việc chúng có phải là tệp đính kèm nội tuyến hay không.

var message = MapiMessage.Load(fileName);

foreach (var attach in message.Attachments)
{
    Console.WriteLine($"{attach.DisplayName0} : {attach.IsInline)}");
}

Kiểm Tra Loại Tệp Đính Kèm (IsReference)

Cái MapiAttachment lớp bao gồm IsReference thuộc tính cho phép các nhà phát triển xác định các tệp đính kèm tham chiếu trong một tin nhắn. Với mẫu mã dưới đây, bạn có thể kiểm tra xem một tệp đính kèm có phải là tệp đính kèm tham chiếu hay không:

foreach (var attachment in msg.Attachments)
{
    if (attachment.IsReference)
    {
        // Process reference attachment
    }
}

Lưu Đính kèm từ Tệp MSG

Để lưu các đính kèm từ tệp MSG:

Lặp qua MapiAttachmentCollection bộ sưu tập và lấy các đính kèm riêng lẻ.
Để lưu các tệp đính kèm, gọi phương thức Save() của lớp MapiAttachment.

Đoạn mã dưới đây cho bạn thấy cách lưu các tệp đính kèm vào ổ đĩa cục bộ.

Trích Xuất Tệp Đính Kèm từ Các Tệp MSG Định Dạng RTF

Đối với các tin nhắn được định dạng dưới dạng RTF, mã dưới đây có thể được sử dụng để phân biệt và trích xuất các tệp đính kèm là Nội Tuyến hoặc xuất hiện dưới dạng Biểu tượng trong phần thân tin nhắn. Đoạn mã dưới đây cho bạn thấy cách Xác định và Trích xuất một tệp đính kèm nhúng từ MSG được định dạng RTF.


var eml = MapiMessage.Load("MSG file with RTF Formatting.msg");

foreach (var attachment in eml.Attachments)
{
    if (IsAttachmentInline(attachment))
    {
        try
        {
            SaveAttachment(attachment, Data.Out/new Guid().ToString());
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

static bool IsAttachmentInline(MapiAttachment attachment)
{
    foreach (var property in attachment.ObjectData.Properties.Values)
    {
        if (property.Name == "\x0003ObjInfo")
        {
            var odtPersist1 = BitConverter.ToUInt16(property.Data, 0);
            return (odtPersist1 & (1 << (7 - 1))) == 0;
        }
    }
    return false;
}

static void SaveAttachment(MapiAttachment attachment, string fileName)
{
    foreach (var property in attachment.ObjectData.Properties.Values)
    {
        if (property.Name == "Package")
        {
            using var fs = new FileStream(fileName, FileMode.Create, FileAccess.Write);
            fs.Write(property.Data, 0, property.Data.Length);
        }
    }
}

Lấy Các Tệp Đính Kèm Tin Nhắn Thư Lồng Nhau

Các tệp đính kèm OLE nhúng cũng xuất hiện trong MapiMessage lớp bộ sưu tập Attachment. Ví dụ mã dưới đây phân tích một tệp tin nhắn để tìm các tệp đính kèm tin nhắn nhúng và lưu nó vào đĩa. The MapiMessage phương thức tĩnh FromProperties() của lớp có thể tạo một tin nhắn mới từ tệp đính kèm nhúng. Đoạn mã dưới đây cho bạn thấy cách lấy các tệp đính kèm tin nhắn thư lồng nhau.

Xóa Đính kèm

Thư viện Aspose Outlook cung cấp chức năng xóa tệp đính kèm khỏi các tệp Microsoft Outlook Message (.msg):

Gọi phương thức RemoveAttachments(). Nó nhận đường dẫn của tệp tin tin nhắn làm tham số. Phương thức này được triển khai dưới dạng public static, vì vậy bạn không cần khởi tạo đối tượng.

Đoạn mã dưới đây cho bạn thấy cách xóa bỏ các tệp đính kèm.

Bạn cũng có thể gọi MapiMessage phương thức tĩnh của lớp DestroyAttachment(). Nó hoạt động nhanh hơn so với RemoveAttachment(), vì phương thức RemoveAttachment() phân tích tệp tin nhắn.

Thêm Đính kèm MSG

Một tin nhắn Outlook có thể chứa các tin nhắn Microsoft Outlook khác trong dạng tệp đính kèm, bao gồm dạng thông thường hoặc nhúng. The MapiAttachmentCollection cung cấp các thành viên quá tải của phương thức Add để tạo tin nhắn Outlook với cả hai loại tệp đính kèm.

Try it out!

Thêm hoặc xóa các tệp đính kèm email với phiên bản miễn phí Aspose.Email Editor App.

Thêm Tệp Đính Kèm Tham Chiếu vào MapiMessages

Cái ReferenceAttachmentOptions lớp đơn giản hoá việc thêm tệp đính kèm tham chiếu bằng cách bao gói tất cả các thuộc tính cần thiết trong một đối tượng duy nhất.

Các Tham Số của ReferenceAttachmentOptions:

sharedLink: Liên kết chia sẻ đầy đủ cho tệp đính kèm được cung cấp bởi dịch vụ web lưu trữ tệp.
url: Vị trí tệp hoặc URL tài nguyên.
providerName: Tên của nhà cung cấp tệp đính kèm tham chiếu (ví dụ: Google Drive, Dropbox).
Ví dụ: Thêm Tệp Đính Kèm Tham Chiếu với ReferenceAttachmentOptions

var options = new ReferenceAttachmentOptions(
    "https://drive.google.com/file/d/1HJ-M3F2qq1oRrTZ2GZhUdErJNy2CT3DF/",
    "https://drive.google.com/drive/my-drive",
    "GoogleDrive");

// Add reference attachment
msg.Attachments.Add("Document.pdf", options);

Nhúng Tin nhắn làm Đính kèm

Đoạn mã dưới đây cho bạn thấy cách nhúng một tệp đính kèm MSG vào một tin nhắn.

Đọc Tin nhắn Nhúng từ Đính kèm

Đoạn mã dưới đây cho bạn thấy cách đọc các tin nhắn nhúng từ đính kèm.

Chèn và Thay Thế Tệp Đính Kèm

Aspose.Email API cung cấp khả năng chèn đính kèm tại chỉ số cụ thể trong tin nhắn cha. Nó cũng cung cấp tiện ích để thay thế nội dung của một đính kèm bằng đính kèm của tin nhắn khác.

Try it out!

Chạy ReplaceAttach dự án ứng dụng đơn giản, và thử các khả năng của Aspose.Email để thay thế tệp đính kèm trong thực tế.

Chèn Đính kèm vào Vị trí Cụ thể

API Aspose.Email cung cấp khả năng chèn một tệp đính kèm MSG vào một MSG cha bằng cách sử dụng phương thức Insert của MapiAttachmentCollection MapiAttachmentCollection Insert(int index, string name, MapiMessage msg). Đoạn mã dưới đây cho bạn thấy cách chèn một tệp đính kèm vào vị trí cụ thể.

Thay thế Nội dung Đính kèm

Điều này có thể được sử dụng để thay thế nội dung tệp đính kèm nhúng bằng các nội dung mới bằng phương thức Replace. Tuy nhiên, không thể dùng để chèn tệp đính kèm với PR_ATTACH_NUM = 4 (ví dụ) vào bộ sưu tập khi collection.Count = 2. Đoạn mã dưới đây cho bạn thấy cách thay thế nội dung tệp đính kèm.

Đổi Tên Tệp Đính Kèm trong MapiMessage

Bạn có thể chỉnh sửa giá trị thuộc tính DisplayName trong các tệp đính kèm MapiMessage.

var msg = MapiMessage.Load(fileName);
msg.Attachments[0].DisplayName = "New display name 1";
msg.Attachments[1].DisplayName = "New display name 2";

Lưu Tệp Đính Kèm từ Các Tin Nhắn Đã Ký Số

Aspose.Email API cung cấp khả năng lấy hoặc đặt giá trị cho biết liệu tin nhắn được ký rõ sẽ được giải mã hay không.

Net: Quản lý Danh bạ Outlook

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

Giống như MapiMessage, Aspose.Email cho phép bạn tạo danh bạ Outlook. The MapiContact lớp cung cấp tất cả các thuộc tính liên quan đến danh bạ cần thiết để tạo một danh bạ Outlook. Bài viết này trình bày cách tạo, lưu và đọc một danh bạ Outlook bằng cách sử dụng MapiContact lớp.

Tạo và Lưu Liên hệ Outlook

Để tạo một liên hệ và lưu nó vào đĩa:

Khởi tạo một đối tượng mới của MapiContact lớp.
Nhập thông tin thuộc tính liên hệ.
Thêm dữ liệu ảnh (nếu có).
Lưu danh bạ dưới dạng MSG hoặc VCard.

Đoạn mã sau cho bạn thấy cách tạo và lưu liên hệ Outlook.

Lưu Danh sách Phân phối MAPI thành Tệp VCF

Đoạn mã mẫu dưới đây minh họa cách lưu danh sách phân phối thành tệp VCF đa danh bạ:

// convert the `msg` object to a `MapiMessage` object
var dlist = (MapiDistributionList)msg.ToMapiMessageItem();

//save the distribution list
var options = new MapiDistributionListSaveOptions(ContactSaveFormat.VCard);
dlist.Save("distribution_list.vcf", options);

Chuyển đổi Tệp VCF Đa Danh bạ sang MapiDistributionList

Aspose.Email hỗ trợ chuyển đổi các tệp VCF đa danh bạ thành MapiDistributionList đối tượng, giúp dễ dàng quản lý và nhập nhiều danh bạ trực tiếp vào ứng dụng của bạn. Tính năng này có thể truy cập thông qua các phương thức tĩnh sau trong MapiDistributionList lớp:

Đoạn mã mẫu dưới đây minh họa cách sử dụng tính năng này:

// Convert a multi-contact VCF file to a MapiDistributionList
MapiDistributionList dlist = MapiDistributionList.FromVCF(fileName);

Save Contacts in VCF Format

Để lưu danh bạ ở định dạng VCF phiên bản 3, sử dụng VCardVersion liệt kê để thiết lập VCardSaveOptions.Version thuộc tính. Đoạn mã mẫu sau đây minh họa cách sử dụng VCardVersion enumerable để lưu danh bạ định dạng VCF phiên bản 3:

var options = new MapiDistributionListSaveOptions(ContactSaveFormat.VCard);
options.Version = VCardVersion.V30;
dlist.Save("distribution_list.vcf", options);

Đọc Danh bạ MAPI

Cái MapiContact lớp có thể được sử dụng để tải danh bạ định dạng Outlook MSG và VCard. Đoạn mã sau đây cho bạn cách tải danh bạ Outlook được lưu dưới dạng MSG và VCF vào một MapiContact.

Tải Danh bạ từ Tệp MSG

Đoạn mã dưới đây cho bạn cách tải danh bạ từ MSG.

Tải Danh bạ từ VCard

Đoạn mã dưới đây cho bạn cách tải danh bạ từ VCard.

Tải Danh bạ MAPI từ vCard với Tùy chọn Tùy chỉnh

Để cung cấp tính linh hoạt hơn khi chuyển đổi các tệp vCard (.vcf) sang danh bạ MAPI, Aspose.Email cho .NET cung cấp một overload MapiContact.FromVCard(string filePath, VCardLoadOptions options) phương thức chấp nhận một VCardLoadOptions đối tượng. Nó cung cấp kiểm soát cải thiện cách các tệp vCard được diễn giải - đặc biệt khi làm việc với các định dạng vCard khác nhau, mã hoá, hoặc các kịch bản phân tích nâng cao.

Đoạn mã mẫu sau đây minh họa cách tải tệp liên hệ .vcf vào một MapiContact đối tượng sử dụng overload chấp nhận VCardLoadOptions. Danh bạ đã tải có thể được sử dụng trong tệp PST, xuất MSG, hoặc các định dạng tương thích Outlook khác.

var mapiContact = MapiContact.FromVCard("contact.vcf", new VCardLoadOptions());
Console.WriteLine(mapiContact.NameInfo.DisplayName);

Tải Danh bạ từ VCard với Mã hoá Được Chỉ định

Đoạn mã dưới đây cho bạn cách tải danh bạ từ VCard với mã hoá đã chỉ định.

Lưu Các Mục Danh bạ VCard với Mã hoá Được Chỉ định

Tùy chỉnh hành vi lưu khi làm việc với tệp VCard bằng cách sử dụng VCardSaveOptions lớp. PreferredTextEncoding thuộc tính của lớp sẽ chỉ định mã hoá sẽ được sử dụng khi lưu các mục danh bạ VCard.

Mẫu mã sau đây cho thấy cách triển khai thuộc tính này trong dự án của bạn:

var cont = VCardContact.Load(fileName, Encoding.UTF8);
var opt = new VCardSaveOptions();
opt.PreferredTextEncoding = Encoding.UTF8;
cont.Save("my.vcard", opt);

Lưu Tệp VCard với Các Trường Mở rộng

Cái UseExtensions thuộc tính cho phép bạn kiểm soát việc có sử dụng các trường mở rộng khi lưu tệp vCard hay không. Khi đặt là true (mặc định), các phần mở rộng được cho phép, cung cấp khả năng tương thích với các trường tùy chỉnh và thông tin liên hệ bổ sung.

Đọc nhiều liên hệ trong định dạng VCard

Thư viện của chúng tôi cho phép lấy danh sách tất cả danh bạ từ một VCard. Điều này có thể thực hiện bằng các phương thức và bước sau:

// Checks whether VCard source stream contains multiple contacts.
VCardContact.IsMultiContacts(Stream stream)

// Loads list of all contacts from VCard file.
VCardContact.LoadAsMultiple(string filePath, Encoding encoding)

// Loads list of all contacts from VCard stream.
VCardContact.LoadAsMultiple(Stream stream, Encoding encoding)

Đoạn mã dưới đây minh họa cách xử lý các tệp VCard chứa nhiều danh bạ:

using (FileStream stream = new FileStream("test.vcf", FileMode.Open, FileAccess.Read))
{
    if(VCardContact.IsMultiContacts(stream))
    {
        List<VCardContact> contacts = VCardContact.LoadAsMultiple(stream, Encoding.UTF8);
    }
}

Tải Danh bạ vCard Bất đồng bộ

Cái VCardContact lớp trong Aspose.Email cho .NET hỗ trợ tải bất đồng bộ các tệp vCard. Điều này cho phép các ứng dụng đọc hiệu quả một hoặc nhiều danh bạ từ tệp .vcf hoặc stream mà không chặn luồng chính - lý tưởng cho các ứng dụng desktop, web hoặc di động hiện đại xử lý danh sách liên hệ lớn. Các phương thức sau của lớp này có thể thực hiện nhiệm vụ:

LoadAsync
LoadAsMultipleAsync

Đoạn mã mẫu dưới đây minh họa cách bất đồng bộ tải nhiều danh bạ vCard từ tệp .vcf bằng VCardContact.LoadAsMultipleAsync. Các danh bạ đã tải được xử lý trong một vòng lặp, in tên hiển thị của mỗi danh bạ ra console. Cách tiếp cận bất đồng bộ đảm bảo ứng dụng vẫn phản hồi nhanh, ngay cả khi đọc các tệp lớn.

var contacts = await VCardContact.LoadAsMultipleAsync("contacts.vcf", new VCardLoadOptions(), CancellationToken.None);

foreach (var contact in contacts)
{
    Console.WriteLine(contact.IdentificationInfo.DisplayName);
}

Hiển thị thông tin liên hệ dưới dạng MHTML

Danh bạ Outlook có thể được chuyển đổi sang MHTML bằng cách sử dụng API Aspose.Email. Ví dụ này cho thấy cách một VCard được tải vào MapiContact và sau đó được chuyển đổi sang MHTML với sự trợ giúp của MailMessage API.

//Load VCF Contact and convert to MailMessage for rendering to MHTML
var contact = MapiContact.FromVCard("Contact.vcf");

MemoryStream ms = new MemoryStream();
contact.Save(ms, ContactSaveFormat.Msg);
ms.Position = 0;
MapiMessage msg = MapiMessage.Load(ms, new MsgLoadOptions());
MailConversionOptions op = new MailConversionOptions();
MailMessage eml = msg.ToMailMessage(op);

//Prepare the MHT format options
MhtSaveOptions mhtSaveOptions = new MhtSaveOptions();
mhtSaveOptions.CheckBodyContentEncoding = true;
mhtSaveOptions.PreserveOriginalBoundaries = true;
MhtFormatOptions formatOp = MhtFormatOptions.WriteHeader | MhtFormatOptions.RenderVCardInfo;
mhtSaveOptions.RenderedContactFields = ContactFieldsSet.NameInfo | ContactFieldsSet.PersonalInfo | ContactFieldsSet.Telephones | ContactFieldsSet.Events;
mhtSaveOptions.MhtFormatOptions = formatOp;
eml.Save("ContactMhtml_out.mhtml", mhtSaveOptions);

Net: Làm việc với Danh sách Phân phối

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

Có thể tạo một danh sách Phân phối bằng Aspose.Email API, đây là một tập hợp của nhiều liên hệ. Danh sách phân phối có thể được lưu vào đĩa ở định dạng Outlook MSG và có thể được xem/điều chỉnh bằng cách mở nó trong MS Outlook.

Tạo và Lưu Danh sách Phân phối

Đoạn mã sau đây cho bạn thấy cách tạo và lưu một danh sách phân phối.

Đọc Danh sách Phân phối từ Tệp PST

Đoạn mã sau đây cho bạn thấy cách đọc một danh sách phân phối từ tệp PST.

Net: Tạo, Lưu và Đọc Nhiệm vụ Outlook

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

Tạo Nhiệm vụ Outlook

Aspose.Email cho .NET cho phép bạn tạo nhiệm vụ Outlook và lưu chúng ở định dạng MSG. MapiTask lớp cung cấp một số thuộc tính như PercentComplete, EstimatedEffort, ActualEffort, History, LastUpdate, và các thứ khác, để đáp ứng và đặt thông tin cần thiết cho một nhiệm vụ Outlook. Bài viết này cho thấy cách tạo, lưu và đọc một MapiTask từ đĩa. Để tạo và lưu một nhiệm vụ vào đĩa:

Khởi tạo một đối tượng mới của MapiTask lớp.
Nhập thông tin thuộc tính của tác vụ.
Lưu tác vụ vào đĩa ở định dạng MSG.

Đoạn mã dưới đây cho bạn thấy cách tạo, lưu và đọc các tác vụ.

Đọc Nhiệm vụ MAPI

Nhiệm vụ được lưu ở định dạng MSG có thể được tải vào MapiMessage và sau đó được chuyển đổi thành MapiTask với quyền truy cập vào các thuộc tính cụ thể của chúng, như tiêu đề và trạng thái. Đoạn mẫu mã dưới đây minh họa cách đọc và thao tác chi tiết nhiệm vụ từ các tệp MSG đã lưu:

Đọc tác vụ VToDo

Nhiệm vụ Outlook được xuất ở định dạng iCalendar dưới dạng sự kiện VToDo có thể được tải bằng MapiTask lớp như được hiển thị trong mẫu mã sau. Đoạn mã dưới đây cho bạn cách đọc một Nhiệm vụ VToDo.

Thêm Thông tin Nhắc nhở vào Nhiệm vụ MAPI

Tương tự như Microsoft Outlook, Aspose.Email có thể thêm thông tin nhắc nhở vào một MapiTask. Đoạn mã sau đây cho bạn thấy cách thêm thông tin nhắc nhở vào một MapiTask.

Thêm Đính kèm vào Nhiệm vụ MAPI

Đoạn mã sau đây cho bạn thấy cách thêm tệp đính kèm vào một MapiTask.

Thêm Chu kỳ vào Nhiệm vụ MAPI

Aspose.Email cho phép tạo nhiệm vụ lặp lại, trong đó chu kỳ có thể là hàng ngày, hàng tuần, hàng tháng hoặc hàng năm. Đoạn mã sau đây cho bạn cách tạo một nhiệm vụ với các loại chu kỳ khác nhau.

Chuyển đổi Nhiệm vụ sang MHT

Aspose.Email có thể tạo MailMessage giống như đầu ra trong quá trình chuyển đổi một MapiTask đến MHT.

Chuyển đổi MSG sang HTML bảo tồn các trường Nhiệm vụ

Cái HtmlFormatOptions.RenderTaskFields định danh cho phép bạn chỉ định rằng các trường nhiệm vụ nên được bao gồm trong tiêu đề của tệp HTML đã lưu. Đoạn mã dưới đây cho thấy cách bảo tồn các trường nhiệm vụ trong tiêu đề khi lưu tệp html:

var msg = MapiMessage.Load("task.msg");
HtmlSaveOptions opt = SaveOptions.DefaultHtml;
opt.HtmlFormatOptions = HtmlFormatOptions.WriteHeader | HtmlFormatOptions.RenderTaskFields;
msg.Save("task.html", opt);

Net: Quản lý mục Lịch Outlook

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

Aspose.Email MapiCalendar lớp cung cấp các phương thức và thuộc tính để đặt các thuộc tính khác nhau của một mục lịch. Phần này cung cấp các mẫu mã cho:

Tạo và Lưu mục Lịch

Đoạn mã mẫu dưới đây cho bạn thấy cách tạo và lưu một mục lịch ở định dạng ICS.

Lưu Các Mục Lịch dưới Dạng Tệp MSG

Đoạn mã mẫu dưới đây cho bạn thấy cách lưu mục lịch dưới dạng MSG.

Lưu ID Sản Phẩm cho Các Mục Lịch MAPI vào ICS

Cái ProductIdentifier thuộc tính của MapiCalendarIcsSaveOptions lớp được sử dụng để lưu một mục lịch MAPI vào tệp iCalendar (ICS) giữ lại thông tin ngày và giờ gốc cũng như một định danh sản phẩm tùy chỉnh. Thuộc tính này chỉ định định danh cho sản phẩm đã tạo đối tượng iCalendar.

Mẫu mã dưới đây cho thấy cách làm việc với dữ liệu iCalendar (ICS) trong một đối tượng lịch MAPI:

var icsSaveOptions = new MapiCalendarIcsSaveOptions
{
    KeepOriginalDateTimeStamp = true,
    ProductIdentifier = "Foo Ltd"
};

mapiCalendar.Save("my.ics", icsSaveOptions);

Lấy Tổng Số Sự Kiện

Lớp CalendarReader cho phép xử lý các sự kiện lịch một cách dễ dàng. Các thuộc tính và phương thức sau cho phép bạn làm việc với nhiều sự kiện:

CalendarReader.Count - Thuộc tính Count của lớp CalendarReader cho phép bạn lấy số lượng thành phần Vevent (sự kiện) có trong lịch, giúp dễ dàng theo dõi tổng số sự kiện.
CalendarReader.IsMultiEvents - Thuộc tính này xác định liệu lịch có chứa nhiều sự kiện hay không. Nó cung cấp giá trị boolean cho biết lịch có hơn một sự kiện, giúp xác định lịch đơn hoặc đa sự kiện.
CalendarReader.Method - Thuộc tính Method lấy loại phương thức iCalendar liên kết với đối tượng lịch. Nó trả về loại phương thức, chẳng hạn như “REQUEST”, “PUBLISH”, hoặc “CANCEL”, cung cấp thông tin quan trọng về mục đích của lịch.
CalendarReader.Version - Lấy phiên bản của iCalendar.
CalendarReader.LoadAsMultiple() Phương thức này cho phép tải danh sách các sự kiện từ một lịch chứa nhiều sự kiện. Nó trả về một danh sách các đối tượng Appointment, cho phép truy cập và xử lý mỗi sự kiện riêng biệt một cách dễ dàng.

Ví dụ mã sau đây trình bày cách bạn có thể thực hiện các khả năng này trong dự án của mình:

var reader = new CalendarReader(fileName);
Console.WriteLine("Calendar contains " + reader.Count + " events");
Console.WriteLine("The Version of the calendar is " + reader.Version);
Console.WriteLine("The Method of the calendar is " + reader.Method);
Console.WriteLine("Is calendar contains contains multiple events? - " + reader.IsMultiEvents);
List<Appointment> appointments = reader.LoadAsMultiple();

Thêm Nhắc Nhở Hiển Thị

Đoạn mã sau cho bạn thấy cách thêm nhắc nhở hiển thị vào lịch.

Thêm Nhắc Nhở Âm Thanh

Đoạn mã mẫu dưới đây cho bạn thấy cách thêm lời nhắc âm thanh vào lịch.

Thêm/Lấy tệp đính kèm từ các tệp lịch

Đoạn mã mẫu dưới đây cho bạn thấy cách thêm/lấy các tệp đính kèm từ các tệp lịch.

Kiểm Tra Trạng Thái Người Nhận trong Yêu Cầu Cuộc Họp

Đoạn mã sau cho bạn thấy cách hiển thị trạng thái của người nhận từ một yêu cầu họp.

Tạo TimeZone Lịch MAPI từ Timezone Chuẩn

Đoạn mã sau cho bạn thấy cách tạo MapiCalendarTimeZone từ Timezone chuẩn.

Đặt Nhắc Nhở cho Cuộc Hẹn

Một lời nhắc có thể được thêm vào khi tạo một cuộc hẹn. Các báo động này có thể kích hoạt dựa trên các tiêu chí khác nhau như n phút trước khi lịch bắt đầu, lặp lại n lần với khoảng thời gian n. Các thẻ khác nhau có thể được sử dụng để tạo các trình kích hoạt này trong đoạn script được bao quanh bởi BEGIN:VALARM và END:VALARM trong một cuộc hẹn. Có nhiều biến thể để đặt lời nhắc cho một cuộc hẹn.

Thêm Thẻ để Đặt Nhắc Nhở

Đoạn mã mẫu dưới đây cho bạn thấy cách đặt lời nhắc bằng cách thêm thẻ.

Chuyển đổi Appointment EML sang MSG với thân HTML

Kể từ phiên bản 19.3, Aspose.Email cung cấp khả năng chuyển đổi Appointment EML sang MSG đồng thời giữ lại phần thân HTML của cuộc hẹn. Aspose.Email cung cấp một MapiConversionOptions.ForcedRtfBodyForAppointment thuộc tính có giá trị mặc định là true. Khi giá trị của MapiConversionOptions.ForcedRtfBodyForAppointment được đặt thành true, nội dung cuộc hẹn sẽ được chuyển sang định dạng RTF. Để giữ định dạng nội dung cuộc hẹn ở dạng HTML, đặt giá trị của MapiConversionOptions.ForcedRtfBodyForAppointment thành false.

Ví dụ sau đây minh họa việc sử dụng MapiConversionOptions.ForcedRtfBodyForAppointment thuộc tính để giữ định dạng nội dung cuộc hẹn ở dạng HTML.

Đặt Trạng Thái của Các Mục Lịch MAPI Thủ Công

Đặt trạng thái của đối tượng Lịch MAPI một cách rõ ràng, ghi đè hành vi mặc định. Điều này cho phép kiểm soát tốt hơn các trạng thái sự kiện lịch, đặc biệt khi xử lý các yêu cầu họp đã nhận. Theo mặc định, khi một cuộc họp được tạo, trạng thái của nó là MapiCalendarState.Meeting. Khi được nhận trong hộp thư đến của người nhận, nó tự động chuyển thành MapiCalendarState.Received, và lớp tin nhắn của nó được cập nhật thành “IPM.Schedule.Meeting.Request”. Sử dụng SetStateForced cho phép đặt thủ công trạng thái thành Received, điều này có thể hữu ích để bảo tồn thông tin người tổ chức khi lưu lịch dưới dạng tệp MSG. Tuy nhiên, điều này có thể ngăn việc chuyển tiếp hoặc gửi lại cuộc họp một cách đúng đắn.

Mẫu mã dưới đây trình bày cách tạo một MapiCalendar đối tượng, gán một người tổ chức, và đặt trạng thái của nó một cách rõ ràng thành cả hai Meeting và Received sử dụng SetStateForced. Sau đó nó lưu mục lịch dưới dạng tệp .msg.

MapiCalendar appointment = new MapiCalendar(
    "LAKE ARGYLE WA 6743",
    "Appointment",
    "This is a very important meeting :)",
    new DateTime(2024, 5, 10, 12, 30, 0, DateTimeKind.Utc),
    new DateTime(2024, 5, 10, 13, 30, 0, DateTimeKind.Utc));

appointment.Organizer = new MapiElectronicAddress
{
    EmailAddress = "test@aaa.com",
    DisplayName = "test display Name"
};

appointment.SetStateForced(MapiCalendarState.Meeting | MapiCalendarState.Received);

appointment.Save("appointment.msg", AppointmentSaveFormat.Msg);

Net: Tạo, Lưu và Đọc Ghi chú Outlook

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

Tạo và Lưu Ghi chú Outlook

Aspose.Email cung cấp khả năng tạo ghi chú Outlook và lưu chúng lên đĩa ở định dạng MSG. MapiNote lớp cung cấp các thuộc tính và phương thức để đặt thông tin công việc. Bài viết này cho thấy cách tạo, lưu và đọc một MapiNote từ đĩa.

Các bước sau có thể được sử dụng để tạo và lưu một ghi chú lên đĩa:

Khởi tạo một đối tượng của MapiNote lớp.
Đặt các thuộc tính khác nhau.
Lưu ghi chú vào đĩa dưới dạng tệp MSG.

Đoạn mã sau đây cho bạn thấy cách tạo và lưu một Ghi chú Outlook.

Đọc Ghi chú MAPI

Cái MapiNote đối tượng lớp được sử dụng để ép kiểu MapiMessage đối tượng tải một ghi chú từ đĩa ở định dạng MSG. Đoạn mã dưới đây cho bạn cách đọc một MapiNote.

Net: Quản lý Định kỳ

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

Làm việc với Lặp lại Hàng ngày

Aspose.Email hỗ trợ tạo các lặp lại hàng ngày bằng cách sử dụng MapiCalendarDailyRecurrencePattern. Ba loại kết thúc lặp lại lịch Mapi khác nhau có thể được sử dụng bao gồm EndAfterNOccurrences, EndAfterDate và NeverEnd. Phần này trình bày việc tạo các mẫu lặp lại hàng ngày khác nhau.

Lặp lại hàng ngày với số lần xuất hiện

Trong loại định kỳ này, số lần lặp lại cần được đặt cùng với các thông tin khác như sau:

Đặt ngày bắt đầu, kết thúc và ngày đến hạn.
Tạo một MapiTask.
Đặt trạng thái nhiệm vụ thành NotAssigned.
Tạo đối tượng định kỳ hàng ngày bằng cách đặt các thuộc tính như PatternType, Period, WeekStartDay, EndType và OccurenceCount.
Đặt thuộc tính MapiTask.Recurrence thành đối tượng định kỳ hàng ngày này.
Lưu tin nhắn này vào đĩa.

Đoạn mã dưới đây cho bạn cách tạo nhiệm vụ với kiểu kết thúc định kỳ là EndAfterNOccurrence.

Hàm sau có thể được sử dụng để tính số sự kiện giữa hai ngày:

Đặt Giá trị Số Lần Xuất Hiện

Đoạn mã sau đây cho bạn thấy cách đặt giá trị số lần xuất hiện.

Định kỳ Hàng ngày: Loại EndAfterDate

Lặp lại Hàng ngày: Đặt giá trị Mỗi ngày

Đoạn mã sau đây cho bạn thấy cách đặt giá trị period là 1 và giá trị INTERVAL là 1 trong chuỗi RRULE.

Giá trị Every Day có thể được đặt thành bất kỳ giá trị thích hợp nào như trong ví dụ sau:

Định kỳ Hàng ngày: Loại NeverEnd

Kiểu kết thúc có thể được đặt bằng cách sử dụng MapiCalendarRecurrenceEndType.NeverEnd. Period hoặc INTERVAL có thể được đặt thành giá trị yêu cầu, ví dụ 1, trong ví dụ sau.

Làm việc với Lặp lại Hàng tuần

Aspose.Email cung cấp các tính năng phong phú để tạo lặp lại hàng tuần bằng cách sử dụng MapiCalendarWeeklyRecurrencePattern. Ba loại kết thúc lặp lại lịch Mapi khác nhau có thể được sử dụng bao gồm EndAfterNOccurrences, EndAfterDate và NeverEnd. Phần này trình bày việc tạo các mẫu lặp lại hàng tuần khác nhau.

Định kỳ Hàng tuần: Loại EndAfterNOccurrences

Trong loại định kỳ này, số lần lặp lại cần được đặt cùng với các thông tin khác như sau:

Đặt ngày bắt đầu, kết thúc và ngày đến hạn.
Tạo một MapiTask.
Đặt trạng thái nhiệm vụ thành NotAssigned.
Tạo đối tượng lặp lại hàng tuần bằng cách đặt các thuộc tính như PatternType, Period, WeekStartDay, EndType và OccurenceCount.
Đặt thuộc tính MapiTask.Recurrence thành đối tượng lặp lại hàng tuần này.
Lưu tin nhắn này vào đĩa.

Đoạn mã sau cho bạn thấy cách tạo một nhiệm vụ với kiểu kết thúc lặp lại là EndAfterNOccurrence.

Hàm sau có thể được sử dụng để tính số sự kiện giữa hai ngày:

Chọn Nhiều Ngày trong Một Tuần

Đoạn mã sau đây cho bạn thấy cách chọn nhiều ngày trong một tuần.

Chọn Nhiều Ngày trong Một Tuần và Đặt Khoảng Thời gian

Đoạn mã sau đây cho bạn thấy cách chọn nhiều ngày trong một tuần và đặt khoảng thời gian.

Định kỳ Hàng tuần: Loại EndAfterDate

Lặp lại Hàng tuần: Đặt giá trị Mỗi ngày

Đoạn mã sau đây cho bạn thấy cách đặt giá trị period là 1 và giá trị INTERVAL là 1 trong chuỗi RRULE.

Giá trị Every Day có thể được đặt thành bất kỳ giá trị thích hợp nào và có thể chọn nhiều ngày như trong ví dụ sau:

Định kỳ Hàng tuần: Loại NeverEnd

Làm việc với Lặp lại Hàng tháng

Aspose.Email hỗ trợ tạo lặp lại hàng tháng bằng cách sử dụng MapiCalendarMonthlyRecurrencePattern. Ba loại kết thúc lặp lại lịch Mapi khác nhau có thể được sử dụng bao gồm EndAfterNOccurrences, EndAfterDate và NeverEnd. Phần này trình bày việc tạo các mẫu lặp lại hàng tháng khác nhau.

Định kỳ Hàng tháng: Loại EndAfterNOccurrences

Trong loại định kỳ này, số lần lặp lại cần được đặt cùng với các thông tin khác như sau:

Đặt ngày bắt đầu, kết thúc và ngày đến hạn.
Tạo một MapiTask.
Đặt trạng thái nhiệm vụ thành NotAssigned.
Tạo đối tượng lặp lại hàng tháng bằng cách đặt các thuộc tính như PatternType, Period, WeekStartDay, EndType và OccurenceCount.
Đặt thuộc tính MapiTask.Recurrence thành đối tượng lặp lại hàng tháng này.
Lưu tin nhắn này vào đĩa.

Đoạn mã sau cho bạn thấy cách tạo một nhiệm vụ với kiểu kết thúc lặp lại là EndAfterNOccurrence.

Hàm sau có thể được sử dụng để tính số sự kiện giữa hai ngày:

Đặt số lần xuất hiện cố định

Đoạn mã sau cho bạn thấy cách đặt số lần xuất hiện cố định.

Định kỳ Hàng tháng: Loại EndAfterDate

"Tùy chọn "End By" trong Mapi Task được thực hiện bằng cách đặt thuộc tính OccurrenceCount được tính bởi hàm GetOccurrenceCount(). Hàm này lấy ngày bắt đầu, ngày kết thúc và chuỗi RRULE. Đoạn mã sau cho bạn thấy cách tạo một lặp lại vào ngày 15 của mỗi tháng giữa ngày bắt đầu và ngày kết thúc.

Định kỳ Hàng tháng: Loại NeverEnd

Đoạn mã sau cho bạn thấy cách đặt kiểu kết thúc bằng cách sử dụng MapiCalendarRecurrenceEndType.NeverEnd.

Làm việc với Lặp lại Hàng năm

Aspose.Email hỗ trợ tạo lặp lại hàng năm bằng cách sử dụng MapiCalendarMonthlyRecurrencePattern. Bằng cách đặt thuộc tính period thành 12, chúng ta có thể đạt được mẫu lặp lại hàng năm. Ba loại kết thúc lặp lại lịch Mapi khác nhau có thể được sử dụng bao gồm EndAfterNOccurrences, EndAfterDate và NeverEnd. Phần này trình bày việc tạo các mẫu lặp lại hàng năm khác nhau.

Định kỳ Hàng năm: Loại EndAfterNOccurrences

Trong loại định kỳ này, số lần lặp lại cần được đặt cùng với các thông tin khác như sau:

Đặt ngày bắt đầu, kết thúc và ngày đến hạn.
Tạo một MapiTask.
Đặt trạng thái nhiệm vụ thành NotAssigned.
Tạo đối tượng lặp lại hàng tháng bằng cách đặt các thuộc tính như PatternType, Period, WeekStartDay, EndType và OccurenceCount.
Đặt thuộc tính MapiTask.Recurrence thành đối tượng lặp lại hàng tháng này để đạt được lặp lại hàng năm.
Lưu tin nhắn này vào đĩa.

Đoạn mã sau cho bạn thấy cách tạo một nhiệm vụ với kiểu kết thúc lặp lại là EndAfterNOccurrence.

Định kỳ Hàng năm: Loại EndAfterDate

Định kỳ Hàng năm: Loại NeverEnd

Đoạn mã sau cho bạn thấy cách đặt kiểu kết thúc bằng cách sử dụng MapiCalendarRecurrenceEndType.NeverEnd.

Tạo Định kỳ từ Quy tắc Định kỳ

Aspose.Email API cung cấp khả năng tạo Mẫu Lặp lại từ Quy tắc Lặp lại (RRULE). Nó phân tích thông tin từ RRULE theo chuẩn iCal RFC 5545 và tạo mẫu lặp lại bằng phương thức MapiCalendarRecurrencePatternFactory.FromString. Đoạn mã sau cho bạn thấy cách tạo mẫu lặp lại từ quy tắc lặp lại.

Thêm Tệp Đính Kèm vào Sự Kiện Lịch Được Lặp Lại

API Aspose.Email cung cấp khả năng thêm tệp đính kèm vào các sự kiện lịch định kỳ.