Documentation – Робота з елементами Outlook

Net: Створення та збереження файлів Outlook

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

Aspose.Email підтримує створення файлів Outlook message (MSG). У цій статті пояснюється, як:

Створити та зберегти повідомлення Outlook

The MailMessage клас має Save() метод, який може зберігати файли Outlook MSG на диск або в потік. Наведені нижче фрагменти коду створюють екземпляр MailMessage клас, встановлює властивості, такі як from, to, subject і body. Метод Save() метод приймає ім’я файлу як аргумент. Крім того, повідомлення Outlook можна створювати з стиснене тіло RTF використовуючи MapiConversionOptions.

Створіть новий екземпляр MailMessage класу та встановлює властивості From, To, Subject і Body.
Викличте MapiMessage клас FromMailMessage метод, який приймає об’єкт MailMessage тип. FromMailMessage метод конвертує MailMessage у MapiMessage (MSG).
Викличте MapiMessage.Save() метод для збереження файлу MSG.

Напишіть наступний код у обробнику події кліку кнопки у Windows‑додатку.

Створення MSG файлів з вкладеннями

У наведеному вище прикладі, ми створили простий файл MSG. Aspose.Email також підтримує збереження файлів повідомлень з вкладеннями. Все, що потрібно зробити, це додати вкладення до MailMessage екземпляр. Додавайте вкладення, викликавши метод Add() у MailMessage.Attachments колекції. Додайте список ListBox до форми, створеної вище, та додайте дві кнопки — одну для додавання, іншу для видалення вкладень. Додаток, який додає вкладення, працює так:

Коли натискається кнопка Add Attachment, відображається Open File Dialog, який допомагає користувачам переглядати та вибирати вкладення.
Після вибору файлу його повний шлях додається до списку.
Коли створюється MSG файл, шляхи до вкладень беруться зі списку та додаються до MailMessage.Attachments колекція.

Напишіть наступний код у обробнику події кліку кнопки Add Attachment.

Коли кнопка Remove Attachment натиснута, видаліть вибрані елементи зі списку. Напишіть наступний код у обробнику кліку кнопки Remove Attachment.

Додайте код для додавання вкладень у MailMessage екземпляр. Остаточний код функції Write Msg наведений нижче.

Створити MSG файли з тілом у форматі RTF

Ви також можете створювати файли Outlook Message (MSG) з тілями у форматі RTF за допомогою Aspose.Email. Тіло RTF підтримує текстове форматування. Створіть його, встановивши MailMessage.HtmlBody властивість. Коли ви конвертуєте MailMessage екземпляр у MapiMessage у випадку, HTML‑тіло конвертується у RTF. Таким чином, форматування тіла листа зберігається.

Наступний приклад створює файл MSG з тілом у форматі RTF. У HTML‑тілі є один заголовок, застосовано форматування жирним та підкресленим. Це форматування зберігається під час конвертації HTML у RTF.

Стискання RTF для тіла повідомлення MAPI

ПРИМІТКА: Процес стискання може уповільнити продуктивність під час створення повідомлень. Розуміючи це та налаштовуючи прапорець стискання відповідно до конкретних вимог і компромісу між розміром файлу та продуктивністю, розробники можуть ефективно керувати створенням файлів MSG і PST при роботі з електронними листами.

Стискання RTF призначене для зменшення розміру повідомлення, а також отриманих файлів PST (Personal Storage Table), які Microsoft Outlook використовує для зберігання електронних листів та інших даних. Використовуючи стискання RTF при налаштуванні тіла повідомлення, розробники можуть зменшити обсяг пам’яті, необхідний для зберігання електронних листів, або оптимізувати пропускну здатність мережі під час передачі повідомлень.

Для цього були розроблені два перевантажені методи:

MapiMessageItemBase.SetBodyContent(string content, BodyContentType contentType, bool compression): Цей метод дозволяє встановити вміст тіла повідомлення, використовуючи вказаний рядок content і вказуючи тип вмісту тіла (наприклад, простий текст, HTML тощо). Необов’язковий параметр compression — це значення, яке визначає, чи слід стиснути вміст за допомогою RTF‑стиснення. Якщо compression має значення true, вміст буде стиснений, що призведе до меншого розміру повідомлення.
MapiMessageItemBase.SetBodyRtf(string content, bool compression): Цей метод конкретно встановлює вміст тіла повідомлення у форматі RTF. Параметр content — це рядок, що представляє RTF‑вміст, який буде встановлений як тіло повідомлення. Як і у попередньому методі, параметр compression визначає, чи слід застосовувати стиснення RTF до вмісту. Якщо compression має значення true, RTF‑вміст буде стиснений для зменшення розміру.

Нижче наведений приклад коду показує, як встановити HTML тіло та залишити його стисненим:

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

Також є MapiConversionOptions.UseBodyCompression властивість. Коли ця властивість увімкнена, стискання RTF тіла застосовується під час конвертації MailMessage у MapiMessage, що призводить до зменшення розміру файлу MSG. Приклад коду наведено нижче:

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

Зберегти повідомлення у статусі чернетки

Листи зберігаються як чернетки, коли хтось розпочав їх редагування, але бажає повернутися до них, щоб завершити пізніше. Aspose.Email підтримує збереження повідомлень електронної пошти у стані чернетки шляхом встановлення прапорця повідомлення. Нижче наведено приклад коду для збереження Outlook листа (MSG) як чернетки.

Net: Завантаження та розбір MSG файлів

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

Використовуючи Aspose.Email для .NET, розробники можуть завантажувати та розпарсувати вміст файлів повідомлень Outlook.

Щоб завантажити MSG‑файли з диска, використовуйте статичний MapiMessage.Load метод MapiMessage клас. Клас забезпечує кілька статичних функцій завантаження для різних сценаріїв.
Для аналізу вмісту файлу MSG, MapiMessage надає ряд методів і властивостей.

У цій статті ви дізнаєтеся, як завантажити та розпарсити MSG‑файл для відображення його вмісту. Приклади коду крок за кроком дадуть вам чітке розуміння того, як реалізувати функціональність завантаження та розбору Outlook MSG‑файлів у вашому проєкті.

Спочатку дізнайтеся, як завантажувати MSG‑файли з файлу або зі стріму.

Завантаження MSG‑файлів

Нижче наведено фрагмент коду, який показує, як завантажити файли 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);
}

Наступний приклад коду показує, як використовувати MailMessage для завантаження повідомлення у форматі MSG.


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

Слід зауважити, що результуюче повідомлення конвертується у формат EML, включаючи вбудовані вкладення повідомлень. Не використовуйте цей метод завантаження, якщо ви хочете зберегти деякі специфічні властивості формату msg оригінального повідомлення.

Щоб зберегти оригінальний формат вбудованих вкладень повідомлень, використайте msgLoadOptions.PreserveEmbeddedMessageFormat властивість.


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

Завантажити зі стріму

Нижче наведено фрагмент коду, який показує, як завантажити файл з потоку.

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

}

Конвертувати EML у MSG з збереженням формату вбудованого EML

Файли EML можна завантажити в MapiMessage клас шляхом створення MailMessage об’єкт і передаючи його до MapiMessage.FromMailMessage метод. Якщо файл EML містить вбудовані файли EML, використовуйте MapiConversionOptions.PreserveEmbeddedMessageFormat для збереження формату вбудованих файлів EML. Нижче наведено фрагмент коду, який показує, як завантажити файли EML у MapiMessage при збереженні формату вбудованих файлів EML.

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

Спробуйте!

Конвертуйте електронні листи та архіви повідомлень онлайн безкоштовно Додаток конвертації Aspose.Email.

Парсити файли повідомлень Outlook

Aspose.Email для .NET надає MapiMessage клас, який використовується для відкриття та парсингу файлу MSG. Оскільки у файлі MSG може бути багато одержувачів, MapiMessage клас надає Отримувачі властивість, що повертає MapiRecipientCollection яка представляє колекцію MapiRecipient об’єкти. The MapiRecipient об’єкт також надає методи для роботи з атрибутами одержувачів.

Наступна послідовність кроків виконує цю задачу:

Створіть екземпляр MapiMessage клас, використовуючи MapiMessage.Load статичний метод.
Відобразіть ім’я відправника, тему та тіло з файлу MSG, використовуючи SenderName, Subject і Тіло властивості.
Використайте Отримувачі властивість для отримання посилання на колекцію MapiRecipient об’єктів, пов’язаних з файлом MSG.
Перебрати MapiRecipientCollection колекція для відображення вмісту кожного MapiRecipient об’єкт через його публічні методи.

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

Спробуйте!

Парсинг електронних файлів онлайн безкоштовно Додаток Aspose.Email Parser.

Net: Управління повідомленнями Outlook

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

Зберегти листи у форматі HTML

Aspose.Email дозволяє зберігати ресурси електронної пошти з відносними шляхами під час експорту повідомлень у формат HTML. Ця функція забезпечує більшу гнучкість у тому, як ресурси пов’язуються у вихідному HTML‑файлі, полегшуючи спільний доступ і відображення збережених листів на різних системах. Щоб зберігати ресурси з відносними шляхами, використовуйте HtmlSaveOptions.UseRelativePathToResources властивість. Значення властивості за замовчуванням — false (ресурси зберігаються з абсолютними шляхами). При встановленні true, ресурси зберігаються з відносними шляхами.

HTML‑файли з відносними шляхами більш портативні і їх можна коректно переглядати незалежно від структури файлів у середовищі розміщення. Ви можете обирати між абсолютними та відносними шляхами залежно від вимог. Ви можете визначити власні шляхи для ресурсів, використовуючи ResourceHtmlRendering подія.

Наведений приклад коду демонструє, як зберегти лист з відносним шляхом до ресурсів за замовчуванням:

var msg = MapiMessage.Load(sourceFileName);

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

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

У цьому випадку ресурси будуть збережені у папці [html file name]_files, за тим же шляхом, що й файл .html, і HTML буде посилатися на ресурси через відносні шляхи.

Наведений приклад коду демонструє, як зберегти з абсолютним шляхом до ресурсів:

var msg = MapiMessage.Load(sourceFileName);

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

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

Як і в першому випадку, ресурси за замовчуванням будуть збережені у папці [html file name]_files, проте HTML буде посилатися на ресурси за допомогою абсолютних шляхів.

Використовуючи ResourceHtmlRendering подія, ви можете встановити кастомні відносні або абсолютні шляхи для ресурсів. При налаштуванні шляхів за допомогою ResourceHtmlRendering обробник події, і оскільки UseRelativePathToResources встановлено в true, вам слід призначити відносний шлях до PathToResourceFile властивість для забезпечення коректного посилання.

Наведений приклад коду демонструє, як вказати власний відносний шлях за допомогою події 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);

Конвертувати MSG у MIME повідомлення

API Aspose.Email забезпечує можливість конвертування файлів MSG у MIME‑повідомлення за допомогою ToMailMessage метод.

Встановити тайм-аути для конвертації та завантаження повідомлень

Наступні можливості дозволять встановити тайм-аут у мілісекундах для процесу конвертації та завантаження:

MailConversionOptions.Timeout властивість — обмежує час у мілісекундах під час конвертації повідомлення.
MailConversionOptions.TimeoutReached - Піднімається, якщо час вичерпано під час конвертування у MailMessage.
MsgLoadOptions.Timeout - Обмежує час у мілісекундах під час конвертування повідомлення.
MsgLoadOptions.TimeoutReached - Піднімається, якщо час вичерпано під час конвертування у MailMessage.

Нижче наведений приклад коду покаже, як встановити тайм-аут під час конвертації повідомлення:

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

Конвертація MSG у EML із збереженням тіла RTF

Конвертація файлу MSG у EML із збереженням тіла RTF може бути виконана двома способами:

за допомогою MsgLoadOptions.PreserveRtfContent властивість MsgLoadOptions class;
за допомогою MailConversionOptions.PreserveRtfContent властивість MailConversionOptions class;

Обидві властивості отримують або встановлюють значення, що вказує, чи зберігати тіло rtf у MailMessage.

Наведені фрагменти коду показують, як конвертувати файл MSG у EML та зберегти тіло 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);

Обробка файлів шаблонів Outlook (.OFT)

Шаблони Outlook дуже корисні, коли потрібно надсилати подібне електронне повідомлення знову і знову. Замість того, щоб кожного разу готувати повідомлення з нуля, спочатку підготуйте його в Outlook і збережіть як шаблон Outlook (OFT). Після цього, коли потрібно надіслати повідомлення, ви можете створити його з шаблону, заощаджуючи час на повторне написання того самого тексту в тілі чи темі, встановленні форматування тощо. Aspose.Email’s MailMessage клас можна використовувати для завантаження та читання файлу шаблону Outlook (OFT). Після завантаження шаблону Outlook в екземпляр MailMessage клас, ви можете оновити відправника, одержувача, тіло, тему та інші властивості. Після оновлення властивостей:

Надішліть електронний лист, використовуючи SmtpClient клас або
Зберегти повідомлення у форматі MSG та виконати подальші оновлення/перевірку за допомогою Microsoft Outlook.

У наведених нижче прикладах коду ми:

Завантажте шаблон, використовуючи MailMessage клас.
Оновити деякі властивості.
Зберегти повідомлення у форматі MSG.

Наведений фрагмент коду показує, як завантажити файл OFT, оновити повідомлення та зберегти його у форматі MSG.

Зберегти файли MSG як шаблони

У наведеному фрагменті коду показано, як зберегти файл Outlook MSG як шаблон.

Визначення типу MAPI повідомлення (OFT або MSG)

Під час завантаження об’єкта MapiMessage з файлу може знадобитися визначити, чи є завантажене повідомлення файлом‑шаблоном чи звичайним файлом електронної пошти. За допомогою IsTemplate властивість MapiMessage клас, ви можете точно визначити, чи є електронний лист шаблоном чи ні. Ця функція може бути корисною при обробці різних типів файлів електронної пошти в додатках і системах.

Нижче наведений приклад коду демонструє, як визначити, чи є MapiMessage у форматі OFT чи 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

Зберегти MapiMessage або MailMessage у форматі OFT

The SaveOptions клас дозволяє вказувати додаткові параметри під час збереження MailMessage або MapiMessage у певному форматі.

Наступний приклад коду демонструє, як зберегти повідомлення у формат 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);
}

Керування цифрово підписаними повідомленнями

Aspose.Email реалізує повний алгоритм об’єкта електронної пошти S/MIME. Це надає API повний контроль над збереженням цифрових підписів під час конвертації повідомлень між форматами.

Зберегти підпис під час конвертації EML у MSG

Aspose.Email зберігає цифровий підпис під час конвертації з EML у MSG. У наведеному фрагменті коду показано, як здійснити конвертацію з EML у MSG.

Конвертувати S/MIME повідомлення з MSG у EML

Aspose.Email зберігає цифровий підпис під час конвертації з MSG у EML, як показано у наведеному фрагменті коду.

Перевірка підписів безпечних листів

Наступні функції доступні для перевірки підпису об’єктів MapiMessage.

SecureEmailManager клас для перевірки підпису безпечних електронних листів.
SmimeResult клас для збереження результатів перевірки.
SecureEmailManager.CheckSignature(MapiMessage msg) метод.
SecureEmailManager.CheckSignature(MapiMessage msg, X509Certificate2 certificateForDecrypt) метод.
SecureEmailManager.CheckSignature(MapiMessage msg, X509Certificate2 certificateForDecrypt, X509Store store) метод.

Нижче наведений приклад коду показує, як впровадити функції у ваш проект:

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

Видалення підписів з MapiMessage

Для кращої сумісності, MapiMessage.RemoveSignature метод і MapiMessage.IsSigned властивості використовуються для видалення цифрового підпису з повідомлення.

Наступний фрагмент коду показує, як впровадити ці функції у ваш проект:

var msg = MapiMessage.Load(fileName);

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

Дешифрування MapiMessage за допомогою сертифікатів

Якщо у вас є зашифровані повідомлення MAPI і потрібно розшифрувати їх за допомогою приватного ключа, збереженого у сертифікаті, наступні можливості Aspose.Email можуть бути корисними:

MapiMessage.IsEncrypted - Повертає значення, що вказує, чи зашифровано повідомлення.
MapiMessage.Decrypt() - Дешифрує це повідомлення (метод шукає у сховищах My поточного користувача та комп’ютера відповідний сертифікат і приватний ключ).
MapiMessage.Decrypt(X509Certificate2 certificate) - Розшифровує це повідомлення за допомогою сертифіката.

У наведеному фрагменті коду показано, як працювати з зашифрованими повідомленнями MAPI:

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

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

Встановити кольорові категорії для файлів MSG

Кольорова категорія позначає електронне повідомлення певною важливістю або типом. Microsoft Outlook дозволяє користувачам призначати кольорові категорії для розрізнення листів. Щоб працювати з кольоровою категорією, використовуйте FollowUpManager. Містить такі функції, як AddCategory, RemoveCategory, ClearCategories і GetCategories.

AddCategory приймає MapiMessage та рядок назви кольорової категорії, наприклад, "Фіолетова категорія" або "Червона категорія", як аргументи.
RemoveCategory приймає MapiMessage та рядок назви кольорової категорії, яку потрібно видалити з повідомлення.
ClearCategories використовується для видалення всіх кольорових категорій з повідомлення.
GetCategories використовується для отримання всіх кольорових категорій із певного повідомлення.

У наведеному прикладі виконуються наступні завдання:

Додати кольорову категорію.
Додати іншу кольорову категорію.
Отримати список усіх категорій.
Видалити всі категорії.

Доступ до інформації про подальші дії у файлах MSG

API Aspose.Email забезпечує можливість доступу до інформації про подальші дії у надісланих або отриманих повідомленнях. Воно може отримати інформацію про підтвердження прочитання, доставки та результати голосування з файлу повідомлення.

Отримання інформації про підтвердження прочитання та доставки

У наведеному фрагменті коду показано, як отримати інформацію про підтвердження прочитання та доставки.

Створення повідомлень пересилання та відповіді

Aspose.Email API забезпечує можливість створення та форматування повідомлень пересилання та відповіді. ReplyMessageBuilder і ForwardMessageBuilder класи API використовуються для створення відповідних листів Reply та Forward. Лист Reply або Forward можна створити, використовуючи будь‑який з режимів OriginalMessageAdditionMode перелічення. Це перелічення має наступні значення:

OriginalMessageAdditionMode.None – Оригінальний лист не включений у лист‑відповідь.
OriginalMessageAdditionMode.Attachment – Оригінальний лист включений як вкладення у лист‑відповідь
OriginalMessageAdditionMode.Textpart – Оригінальне повідомлення включається як текст у тіло відповіді.

Створення повідомлень‑відповідей

Наведений нижче фрагмент коду показує, як створити повідомлення‑відповідь.

Створення повідомлень пересилання

Наведений фрагмент коду показує, як створити лист‑перенаправлення.

Net: Використання контролю Aspose Outlook для перетягування повідомлень Outlook у Windows Forms

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

Aspose.Email підтримує функцію перетягування та копіювання Microsoft Outlook. Це дозволяє розробникам легко створювати UI‑елементи, що реагують на події перетягування з Outlook. Наведений приклад показує, як створити панель, на яку користувачі можуть перетягнути повідомлення з Outlook і відпустити його, а програма зберігає повідомлення у файли MSG. Наведений фрагмент коду демонструє, як налаштувати контроль Aspose Outlook, який може приймати перетягнуті повідомлення Microsoft Outlook.

Створіть застосунок Windows Forms.
Додайте посилання на збірку Aspose.Email.
Перейдіть до Aspose.Email.dll і натисніть OK.

UI‑елемент, створений у цьому прикладі, — це панель. Щоб створити панель:

Клацніть правою кнопкою миші ваш проєкт у панелі рішень і виберіть Add, а потім New item у меню.
Створіть клас під назвою MyPanel:
Нехай MyPanel буде підкласом System.Windows.Form.Panel і додайте властивість Aspose.Email.Windows.Forms.FileDropTargetManager до MyPanel:

Перевизначте методи OnHandleCreated та OnHandleDestroyed, щоб зареєструвати MyPanel за допомогою Aspose.Email.Windows.Forms.FileDropTargetManager:

Збірка проєкту.

MyPanel готовий до використання. Ця панель приймає події перетягування з Outlook.

Відкрийте панель інструментів і перетягніть MyPanel на вашу форму Windows Forms:

Додайте обробник події DragDrop для MyPanel. (Не забудьте встановити властивість AllowDrop у true у панелі властивостей та змінити властивість BackColor у MyPanel на бажаний колір.)

Додайте наступний рядок у метод InitializeComponent() головної форми:

Реалізуйте обробник події DragDrop, щоб зберегти повідомлення, перетягнуті з Outlook, у файли MSG.
Приведіть DragEventArgs до Aspose.Email.Windows.Forms.FileDragEventArgs, який містить масив властивості Files, що представляє ціль перетягування користувача.

Якщо користувач перетягне кілька повідомлень з Outlook і відпустить їх на MyPanel, Files.Count — це кількість повідомлень, а Files i перебирає кожне повідомлення.

Запустіть проєкт і протестуйте його.

Тепер ви можете перетягувати повідомлення з Outlook і відпускати їх у ваш застосунок. Застосунок запитує вас зберегти ці повідомлення у файли MSG.

Net: Робота з параметрами голосування та реакціями у MSG

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

Створити параметри голосування за допомогою MapiMessage

Microsoft Outlook пропонує функціонал створення опитування під час складання нового листа, дозволяючи користувачам включати варіанти голосування, такі як Так, Ні, Можливо тощо. Aspose.Email забезпечує подібну можливість при програмному створенні нового повідомлення Outlook. The FollowUpOptions class надає VotingButtons властивість, яку можна використовувати для встановлення або отримання параметрів голосування. MapiMessage посилається на клас у просторі імен Aspose.Email, який представляє електронне повідомлення у форматі Messaging Application Programming Interface (MAPI), що зазвичай використовується Microsoft Outlook. Використовуючи клас MapiMessage, розробники можуть додавати кнопки опитування до листа. У цій статті наведено докладний приклад створення MapiMessage з параметрами голосування для створення опитування.

Створити опитування

Наступний фрагмент коду демонструє, як створити опитування у повідомленні Outlook за допомогою Aspose.Email. The FollowUpManager клас полегшує налаштування параметрів голосування.

// 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: Надає властивості для налаштування дій подальшого реагування, таких як кнопки голосування.
VotingButtons: Рядкова властивість, у якій різні параметри голосування розділені крапкою з комою.
FollowUpManager.SetOptions: Застосовує вказані параметри подальших дій до повідомлення.

Читати параметри голосування

Щоб отримати параметри голосування з MapiMessage, ви можете використати the GetOptions метод. Цей метод не лише отримує кнопки голосування, а й може надати додаткові параметри, такі як категорії, за потреби.

// 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: Отримує FollowUpOptions об’єкт з повідомлення, який включає кнопки голосування та можливо інші властивості.
VotingButtons: Параметри витягуються як рядок, розділений крапкою з комою, що дозволяє легке відображення або маніпуляції.

Читати кнопки голосування

Якщо вам потрібен доступ лише до кнопок голосування у вигляді списку окремих рядків, ви можете використати GetVotingButtons метод, який повертає їх у вигляді колекції.

// 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: Повертає колекцію рядків кнопок голосування, що зручно для ітерації по них та виконання операцій, таких як відображення чи модифікація.

Додати кнопки голосування

Ви можете додати додаткові кнопки голосування до існуючого повідомлення, використовуючи AddVotingButton метод. Це може бути корисним для динамічного оновлення параметрів голосування.

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

AddVotingButton: Додає нову опцію голосування до існуючих кнопок голосування повідомлення, дозволяючи динамічно налаштовувати опитування.

Видалити кнопки голосування

Ви можете захотіти видалити конкретні кнопки голосування або очистити всі кнопки в повідомленні. Наступний код демонструє обидві дії за допомогою RemoveVotingButton і ClearVotingButtons методи.

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

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

RemoveVotingButton: Видаляє конкретну кнопку голосування за назвою.
ClearVotingButtons: Видаляє всі кнопки голосування, ефективно скидаючи параметри голосування.

Читання результатів голосування

Aspose.Email також дозволяє читати результати голосування від отримувачів повідомлення. Ви можете отримати доступ до таких властивостей, як відповідь отримувача та час відповіді.

// 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: Представляє отримувача у MapiMessage, забезпечуючи доступ до даних окремих відповідей.
*PR_RECIPIENT_AUTORESPONSE_PROP_RESPONSE: Тег властивості, що зберігає відповідь голосу отримувача.
PR_RECIPIENT_TRACKSTATUS_TIME: Тег властивості, що записує час відповіді отримувача.

Отримати інформацію про реакції з MSG

The GetReactions метод FollowUpManager клас дозволяє отримати список реакцій на MAPI‑повідомлення, що спрощує аналіз взаємодії користувачів. Наступний приклад коду демонструє, як отримати доступні реакції для вказаного повідомлення, надаючи уявлення про взаємодії користувачів:

// 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: Керування позначками та термінами виконання для файлів Outlook MSG

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

Встановити позначки Follow-Up та дати виконання для файлів MSG

Позначка Follow-Up позначає електронний лист для певної дії. Microsoft Outlook дозволяє користувачам позначати повідомлення та у налаштуваннях позначки задавати дату виконання. Outlook надсилає нагадування одержувачеві, щоб спонукати його виконати дію. Програмне встановлення позначок та дат виконання дозволяє розробникам автоматизувати певні типи листів і допомагати одержувачам пам’ятати про необхідність дії. Наприклад, це може використовуватись для надсилання щомісячних повідомлень команді продажів, щоб нагадати їм про підготовку звітів; або для надсилання повідомлення всім співробітникам з нагадуванням про корпоративну зустріч. Aspose.Email для .NET підтримує встановлення позначки Follow-Up та дати виконання для MapiMessage об’єкти, що використовуються FollowUpManager і FollowUpOptions. Існує кілька варіантів, у яких позначка Follow-Up може бути встановлена на повідомленні. Вони всі використані у наведеному нижче прикладі коду:

Встановити мітку для подальших дій до повідомлення
Додати дату виконання та дату нагадування до повідомлення
Додати мітку до повідомлення одержувача.
Позначити як завершене.
Видалити мітку.
Прочитати параметри follow up.

Встановити позначки Follow-Up

Наступний фрагмент коду показує, як встановити прапорець follow-up.

Встановити позначку Follow-Up для одержувачів

Наступний фрагмент коду показує, як встановити follow-up для отримувачів.

Позначити позначки Follow-Up як виконані

Наступний фрагмент коду показує, як позначити прапорець follow-up як завершений.

Видалити позначки Follow-Up

Наступний фрагмент коду показує, як видалити прапорець follow-up.

Читання параметрів прапорця подальших дій

Наступний фрагмент коду показує, як прочитати параметри прапорця follow-up для повідомлення.

Net: Робота з властивостями MAPI

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

Доступ та встановлення Outlook MAPI властивості

The MapiProperty клас представляє властивість MAPI, яка містить:

Name: рядок, який представляє назву властивості.
Tag: значення типу long, яке представляє тег властивості.
Data: масив байтів, який представляє властивість даних.

Отримання MAPI властивостей за допомогою тегів властивостей

Для отримання MAPI властивостей:

Створіть екземпляр MapiMessage by завантаження з файлів або потоку.
Отримати MapiProperty з MapiMessage.Properties by MapiPropertyTag ключі.

Нижче наведено фрагмент коду, який показує, як отримати MAPI властивість, використовуючи тег MAPI властивості.

Встановити властивості MAPI

Наступний фрагмент коду показує, як встановити властивості MAPI.

де визначення методу convertDateTime наведено нижче:

Додаткові властивості

Нижче наведений фрагмент коду показує, як встановити додаткові MAPI властивості.

Читання названих MAPI властивостей з MSG файлів

Нижче наведений фрагмент коду показує, як читати іменовані MAPI властивості з файлу MSG.

Читання названих MAPI властивостей з прикріплень

Aspose.Email також дозволяє проходитися по властивостям MapiAttachment і шукати іменовану властивість, схожим способом як у прикладі вище, для MapiMessage. Нижче наведений фрагмент коду показує, як шукати іменовану властивість у колекції властивостей вкладень.

Видалення властивостей з MSG та вкладень

Нижче наведений фрагмент коду показує, як видалити властивості з MSG та вкладень.

Net: Керування вкладеннями повідомлень

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

Обробка вкладень в Outlook

Створення та збереження Outlook повідомлень (MSG) файлів пояснює, як створювати та зберігати повідомлення, а також створювати MSG‑файли з вкладеннями. У цій статті розглядається, як керувати вкладеннями Microsoft Outlook за допомогою Aspose.Email. Вкладення з файлу повідомлення отримуються і зберігаються на диск за допомогою MapiMessage клас Вкладення властивість. Цей Вкладення властивість є колекцією типу MapiAttachmentCollection клас.

Перевірка типу вкладення (вбудоване чи звичайне)

Вбудовані та звичайні вкладення виконують різні функції. Вбудовані вкладення візуально інтегруються у повідомлення електронної пошти і зазвичай є зображеннями або медіа‑файлами. Натомість звичайні вкладення — це окремі файли, приєднані до листа, які можуть включати різні типи файлів. The MapiAttachment.IsInline властивість MapiAttachment клас отримує значення, що вказує, чи є вкладення вбудованим чи звичайним.

Наступний приклад коду витягує та відображає інформацію про кожне вкладення у завантаженому MapiMessage, включаючи їхні назви для відображення та чи є вони вбудованими (inline) або ні.

var message = MapiMessage.Load(fileName);

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

Перевірка типу вкладення (IsReference)

The MapiAttachment клас включає IsReference властивість, яка дозволяє розробникам ідентифікувати референсні вкладення у повідомленні. За допомогою наступного прикладу коду можна перевірити, чи є вкладення референсним:

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

Зберегти прикріплення з MSG файлів

Щоб зберегти прикріплення з MSG файлу:

Ітеруйте через MapiAttachmentCollection колекцію та отримайте окремі прикріплення.
Щоб зберегти вкладення, викличте метод Save() класу MapiAttachment.

Наступний фрагмент коду показує, як зберегти вкладення на локальний диск.

Витягнути вкладення з MSG‑файлів у форматі RTF

Для повідомлень у форматі RTF можна використати наступний код, щоб розрізнити та витягнути вкладення, які є або вбудованими (Inline), або відображаються як іконка у тілі повідомлення. Наступний фрагмент коду показує, як ідентифікувати та витягти вбудоване вкладення з MSG, сформованого у форматі 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);
        }
    }
}

Отримати вбудовані поштові повідомлення‑вкладення

Вбудовані OLE‑вкладення також з’являються у MapiMessage Колекція класу Attachment. Наступний приклад коду розбирає файл повідомлення на предмет вбудованих вкладень повідомлень та зберігає його на диск. The MapiMessage Статичний метод класу FromProperties() може створити нове повідомлення з вбудованого вкладення. Наступний фрагмент коду показує, як отримати вкладення вбудованих поштових повідомлень.

Видалити прикріплення

Бібліотека Aspose Outlook забезпечує можливість видаляти вкладення з файлів Microsoft Outlook Message (.msg):

Викличте метод RemoveAttachments(). Він приймає шлях до файлу повідомлення як параметр. Реалізовано як публічний статичний метод, тому не потрібно створювати екземпляр об’єкта.

Наступний фрагмент коду показує, як видаляти вкладення.

Ви також можете викликати the MapiMessage статичний метод класу DestroyAttachment(). Працює швидше, ніж RemoveAttachment(), оскільки метод RemoveAttachment() розбирає файл повідомлення.

Додати MSG прикріплення

Повідомлення Outlook може містити інші повідомлення Microsoft Outlook у вигляді вкладень, будь то звичайні або вбудовані повідомлення. The MapiAttachmentCollection надає перевантажені члени методу Add для створення Outlook‑повідомлень з обома типами вкладень.

Спробуйте!

Додавати або видаляти електронні вкладення за допомогою безкоштовного Aspose.Email Editor App.

Додати референсні вкладення до MapiMessages

The ReferenceAttachmentOptions клас спрощує додавання референсних вкладень, інкапсулюючи всі необхідні властивості в одному об’єкті.

Параметри ReferenceAttachmentOptions:

sharedLink: Повністю кваліфіковане спільне посилання на вкладення, надане веб‑сервісом, що розміщує файл.
url: Розташування файлу або URL ресурсу.
providerName: Назва провайдера референсних вкладень (наприклад, Google Drive, Dropbox).
Приклад: Додавання референсного вкладення за допомогою 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);

Вбудовування повідомлень як прикріплень

Наступний фрагмент коду показує, як вбудувати MSG‑файл як вкладення в повідомлення.

Читання вбудованих повідомлень з прикріплень

Нижче наведений фрагмент коду показує, як читати вбудовані повідомлення з прикріплень.

Вставка та заміна вкладення

Aspose.Email API надає можливість вставляти вкладення у вказаний індекс батьківського повідомлення. Він також забезпечує можливість заміняти вміст вкладення іншим повідомлення‑вкладенням.

Спробуйте!

Запустіть ReplaceAttach простий проєкт програми, і спробуйте можливості Aspose.Email для заміни вкладень у дії.

Вставка прикріплень у певних місцях

API Aspose.Email забезпечує можливість вставити MSG‑вкладення до батьківського MSG за допомогою методу Insert колекції MapiAttachmentCollection MapiAttachmentCollection Insert(int index, string name, MapiMessage msg). Наступний фрагмент коду показує, як вставити вкладення у конкретне місце.

Замінити вміст прикріплення

Це можна використати для заміни вбудованого вмісту вкладень новим за допомогою методу Replace. Однак це не можна застосовувати для вставлення вкладення з PR_ATTACH_NUM = 4 (наприклад) у колекцію, у якої collection.Count = 2. Наступний фрагмент коду показує, як замінити вміст вкладення.

Перейменування вкладень у MapiMessage

Можливо редагувати значення властивості DisplayName у вкладеннях MapiMessage.

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

Зберегти вкладення з цифрово підписаних повідомлень

Aspose.Email API надає можливість отримати або встановити значення, що вказує, чи буде декодовано чисто підписане повідомлення.

Net: Керування контактами Outlook

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

Подібно до MapiMessage, Aspose.Email дозволяє створювати контакти Outlook. MapiContact клас надає всі властивості, пов’язані з контактами, необхідні для створення контакту Outlook. У цій статті показано, як створити, зберегти та читати контакт Outlook за допомогою MapiContact клас.

Створити та зберегти Outlook контакт

Щоб створити контакт та зберегти його на диск:

Створіть новий об’єкт MapiContact клас.
Введіть інформацію про властивості контакту.
Додати дані фотографії (за наявності).
Збережіть контакт у форматі MSG або VCard.

Нижче наведено фрагмент коду, який показує, як створити та зберегти Outlook контакт.

Зберегти MAPI‑списки розсилки у VCF‑файли

Нижчий приклад коду демонструє, як зберегти список розсилки у багатоконтактний VCF‑файл:

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

Конвертувати багатоконтактні VCF‑файли у MapiDistributionList

Aspose.Email підтримує конвертацію багатоконтактних VCF‑файлів у MapiDistributionList об’єктів, що спрощує керування та імпорт кількох контактів безпосередньо у ваші застосунки. Ця функція доступна через наступні статичні методи в MapiDistributionList клас:

Нижчий приклад коду демонструє, як використати цю функцію:

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

Збереження контактів у форматі VCF

Щоб зберегти контакт у форматі VCF версії 3, використайте VCardVersion перелік для встановлення VCardSaveOptions.Version властивість. Нижче наведено приклад коду, який демонструє використання VCardVersion перелік для збереження контакту у форматі VCF версії 3:

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

Читання MAPI‑контактів

The MapiContact клас можна використовувати для завантаження контактів у форматах Outlook MSG та VCard. Наступний фрагмент коду показує, як завантажити контакти Outlook, збережені як MSG та VCF, у MapiContact.

Завантажити контакти з MSG‑файлів

Наступний фрагмент коду показує, як завантажити контакти з MSG.

Завантажити контакти з VCard

Наступний фрагмент коду показує, як завантажити контакти з VCard.

Завантажити MAPI‑контакти з vCard з користувацькими параметрами

Для забезпечення більшої гнучкості при конвертації файлів vCard (.vcf) у MAPI‑контакти Aspose.Email для .NET надає перевантаження MapiContact.FromVCard(string filePath, VCardLoadOptions options) метод, що приймає VCardLoadOptions об’єкт. Це забезпечує покращений контроль над тим, як інтерпретуються файли vCard — особливо при роботі з різними форматами vCard, кодуваннями або складними сценаріями розбору.

Наступний приклад коду демонструє, як завантажити файл контакту .vcf у MapiContact об’єкт, використовуючи перевантаження, яке приймає VCardLoadOptions. Завантажений контакт потім можна використати у PST‑файлах, експорті MSG або інших сумісних з Outlook форматах.

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

Завантажити контакти з VCard з вказаним кодуванням

Наступний фрагмент коду показує, як завантажити контакти з VCard з вказаним кодуванням.

Зберігати елементи контактів VCard із заданим кодуванням

Налаштуйте поведінку збереження під час роботи з VCard‑файлами за допомогою VCardSaveOptions клас. The PreferredTextEncoding властивість класу, яка визначатиме кодування, що використовується при збереженні елементів контакту VCard.

Наступний приклад коду показує, як реалізувати цю властивість у вашому проєкті:

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

Зберігати VCard‑файли з розширеними полями

The UseExtensions властивість дозволяє контролювати, чи можна використовувати розширені поля під час збереження VCard‑файлів. Якщо встановлено true (за замовчуванням), розширення дозволені, забезпечуючи сумісність із користувацькими полями та додатковою інформацією про контакти.

Читати кілька контактів у форматі VCard

Наша бібліотека дозволяє отримати список усіх контактів з VCard. Це можна зробити за допомогою наступних методів та кроків:

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

Наступний фрагмент коду демонструє, як обробляти VCard‑файли, що містять кілька контактів:

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

Асинхронне завантаження vCard‑контактів

The VCardContact клас у Aspose.Email для .NET підтримує асинхронне завантаження vCard‑файлів. Це дозволяє застосункам ефективно читати окремі або кілька контактів з .vcf‑файлів або потоків без блокування головного потоку — ідеально для сучасних настільних, веб‑ чи мобільних застосунків, що працюють з великими списками контактів. Наступні методи цього класу можуть виконати це завдання:

LoadAsync
LoadAsMultipleAsync

Наступний приклад коду демонструє, як асинхронно завантажити кілька vCard‑контактів з файлу .vcf за допомогою VCardContact.LoadAsMultipleAsync. Завантажені контакти оброблюються у циклі, виводячи ім’я контакту у консоль. Асинхронний підхід забезпечує, що застосунок залишатиметься реагуючим, навіть під час читання великих файлів.

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

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

Відобразити інформацію контакту у MHTML

Контакт Outlook можна конвертувати у MHTML за допомогою API Aspose.Email. Цей приклад показує, як VCard завантажується у MapiContact а потім конвертовано у MHTML за допомогою 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: Робота зі списками розповсюдження

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

Можна створити список розсилки за допомогою Aspose.Email API, який є колекцією декількох контактів. Список розсилки можна зберегти на диск у форматі Outlook MSG та переглядати/маніпулювати, відкривши його у MS Outlook.

Створити та зберегти списки розсилки

Наведений фрагмент коду показує, як створити та зберегти список розповсюдження.

Прочитати списки розсилки з файлів PST

Наведений фрагмент коду показує, як прочитати список розповсюдження з PST‑файлу.

Net: Створення, збереження та читання завдань Outlook

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

Створення завдань Outlook

Aspose.Email for .NET дозволяє створювати завдання Outlook і зберігати їх у форматі MSG. MapiTask клас надає ряд властивостей, таких як PercentComplete, EstimatedEffort, ActualEffort, History, LastUpdate, та інші, для заповнення та встановлення інформації, необхідної для завдання Outlook. У цій статті показано, як створити, зберегти та прочитати MapiTask з диска. Щоб створити та зберегти завдання на диск:

Створіть новий об’єкт MapiTask клас.
Введіть інформацію про властивості завдання.
Зберегти завдання на диск у форматі MSG.

Наступний фрагмент коду показує, як створювати, зберігати та читати завдання.

Читання завдань MAPI

Завдання, збережені у форматі MSG, можна завантажити в MapiMessage а потім конвертовано у MapiTask з доступом до їхніх специфічних властивостей, таких як тема та статус. Нижче наведений приклад коду демонструє, як читати та маніпулювати деталями завдання з збережених MSG файлів:

Прочитати завдання VToDo

Завдання Outlook, експортовані у формат iCalendar як події VToDo, можна завантажити за допомогою MapiTask клас, як показано у наведеному прикладі коду. Нижче наведений фрагмент коду показує, як прочитати завдання VToDo.

Додати інформацію про нагадування до MAPI завдань

Подібно до Microsoft Outlook, Aspose.Email може додати інформацію про нагадування до MapiTask. Наведений фрагмент коду показує, як додати інформацію про нагадування до MapiTask.

Додати вкладення до MAPI завдань

Наведений фрагмент коду показує, як додати вкладення до MapiTask.

Додати повторення до MAPI завдань

Aspose.Email дозволяє створювати повторювані завдання, де повторення може бути щоденним, щотижневим, щомісячним або щорічним. Нижче наведений фрагмент коду показує, як створити завдання з різними типами повторення.

Конвертувати завдання у MHT

Aspose.Email може генерувати MailMessage наприклад вихід під час конвертації MapiTask у MHT.

Конвертація MSG в HTML зі збереженням полів завдань

The HtmlFormatOptions.RenderTaskFields перечислення дозволяє вказати, що поля завдання повинні бути включені у заголовок збереженого HTML-файлу. Нижче наведений фрагмент коду показує, як зберегти поля завдання у заголовку під час збереження HTML-файлу:

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

Net: Керування елементами календаря Outlook

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

Aspose.Email MapiCalendar Клас надає методи та атрибути для встановлення різних властивостей елементу календаря. У цьому розділі наведено приклади коду для:

Створити та зберегти елементи календаря

У наведеному фрагменті коду показано, як створити і зберегти елемент календаря у форматі ICS.

Зберегти елементи календаря як файли MSG

У наведеному фрагменті коду показано, як зберегти елемент календаря у форматі MSG.

Зберегти ідентифікатори продукту для елементів MAPI Calendar у форматі ICS

The ProductIdentifier властивість MapiCalendarIcsSaveOptions клас використовується для збереження елементу календаря MAPI у файл iCalendar (ICS), зберігаючи оригінальну дату і час, а також користувацький ідентифікатор продукту. Властивість вказує ідентифікатор продукту, який створив об’єкт iCalendar.

Наведений приклад коду показує, як працювати з даними iCalendar (ICS) у об’єкті MAPI календаря:

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

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

Отримати загальну кількість подій

Клас CalendarReader дозволяє легко працювати з подіями календаря. Наступні властивості та метод дозволяють працювати з кількома подіями:

CalendarReader.Count – Властивість Count класу CalendarReader дозволяє отримати кількість компонентів Vevent (подій), присутніх у календарі, що спрощує підрахунок загальної кількості подій.
CalendarReader.IsMultiEvents – Ця властивість визначає, чи містить календар кілька подій. Вона повертає булеве значення, яке вказує, чи містить календар більше однієї події, допомагаючи розрізняти календарі з однією чи декількома подіями.
CalendarReader.Method – Властивість Method отримує тип методу iCalendar, пов’язаний з об’єктом календаря. Вона повертає тип методу, наприклад “REQUEST”, “PUBLISH” або “CANCEL”, надаючи цінну інформацію про призначення календаря.
CalendarReader.Version – Повертає версію iCalendar.
CalendarReader.LoadAsMultiple() Цей метод дозволяє завантажувати список подій з календаря, що містить кілька подій. Він повертає список об’єктів Appointment, забезпечуючи легкий доступ і обробку кожної події окремо.

Наведений приклад коду демонструє, як ви можете реалізувати ці можливості у вашому проєкті:

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

Додати візуальні нагадування

Наведений фрагмент коду показує, як додати візуальне нагадування до календаря.

Додати аудіо нагадування

У наведеному фрагменті коду показано, як додати аудіо нагадування до календаря.

Додати/отримати вкладення з файлів календаря

У наведеному фрагменті коду показано, як додати/отримати вкладення з файлів календаря.

Перевірити статус одержувачів у запитах на зустріч

Наведений фрагмент коду показує, як відобразити статус одержувачів у запиті на зустріч.

Створити часовий пояс MAPI Calendar зі стандартного часового поясу

Наведений фрагмент коду показує, як створити MapiCalendarTimeZone зі стандартного часового поясу.

Встановити нагадування для зустрічей

Нагадування можна додати під час створення зустрічі. Ці сигнали можуть спрацьовувати за різними критерями, наприклад, за n хвилин до початку розкладу, повторюватися n разів з інтервалом n. Різні теги можна використовувати для створення цих тригерів у скрипті, що знаходиться між BEGIN:VALARM і END:VALARM у межах зустрічі. Існує кілька варіантів, у яких можна встановити нагадування для зустрічі.

Додати теги для встановлення нагадувань

У наведеному фрагменті коду показано, як встановити нагадування, додаючи теги.

Конвертувати Appointment EML у MSG з HTML‑тілом

Починаючи з версії 19.3, Aspose.Email надає можливість конвертувати Appointment EML у MSG, зберігаючи HTML‑тіло зустрічі. Aspose.Email надає MapiConversionOptions.ForcedRtfBodyForAppointment властивості, яка має значення за замовчуванням true. Коли значення MapiConversionOptions.ForcedRtfBodyForAppointment встановлено на true, тіло зустрічі конвертується у формат RTF. Щоб зберегти формат тіла зустрічі у форматі HTML, встановіть значення MapiConversionOptions.ForcedRtfBodyForAppointment на false.

У наведеному прикладі демонструється використання MapiConversionOptions.ForcedRtfBodyForAppointment властивість, яка зберігає формат тіла зустрічі у форматі HTML.

Вручну встановити стан елементів MAPI Calendar

Встановити стан об’єкта MAPI Calendar явно, перевизначаючи поведінку за замовчуванням. Це дає кращий контроль над станами подій календаря, особливо при обробці отриманих запитів на зустріч. За замовчуванням, коли створюється зустріч, її стан — MapiCalendarState.Meeting. Коли отримано у вхідні повідомлення отримувача, він автоматично змінюється на MapiCalendarState.Received, та його клас повідомлення оновлено до “IPM.Schedule.Meeting.Request”. Використовуючи SetStateForced дозволяє вручну встановити стан Received, що може бути корисним для збереження інформації про організатора під час збереження календаря як файлу MSG. Однак це може завадити правильному пересиленню чи повторному надсиланню зустрічі.

Наведений приклад коду демонструє, як створити MapiCalendar об’єкт, призначити організатора та явно встановити його стан на обидва Meeting і Received за допомогою SetStateForced. Потім він зберігає елемент календаря як файл .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: Створення, збереження та читання нотаток Outlook

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

Створити та зберегти нотатки Outlook

Aspose.Email надає можливість створювати нотатки Outlook і зберігати їх на диск у форматі MSG. MapiNote клас надає властивості та методи для встановлення інформації про завдання. У цій статті показано, як створити, зберегти та прочитати MapiNote з диска.

Наступні кроки можна використати для створення та збереження нотатки на диск:

Створіть об’єкт MapiNote клас.
Встановіть різні властивості.
Збережіть нотатку на диск у вигляді файлу MSG.

Нижче наведений фрагмент коду показує, як створити та зберегти нотатку Outlook.

Читання нотаток MAPI

The MapiNote об’єкт класу використовується для приведення MapiMessage об’єкт, який завантажує нотатку з диска у форматі MSG. Нижче наведений фрагмент коду показує, як прочитати MapiNote.

Net: Керування повтореннями

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

Робота з щоденними повтореннями

Aspose.Email підтримує створення щоденних повторень за допомогою MapiCalendarDailyRecurrencePattern. Можна використовувати три різні типи завершення повторення календаря Mapi, включаючи EndAfterNOccurrences, EndAfterDate та NeverEnd. У цьому розділі демонструється створення різних шаблонів щоденних повторень.

Щоденні повторення з кількістю випадків

У цьому типі повторення кількість повторень слід встановити разом з іншою інформацією наступним чином:

Встановіть дату початку, завершення та виконання.
Створити MapiTask.
Встановити стан завдання на НеПризначено.
Створіть об’єкт щоденного повторення, встановивши властивості, такі як PatternType, Period, WeekStartDay, EndType та OccurenceCount.
Встановіть властивість MapiTask.Recurrence у цей об’єкт щоденного повторення.
Збережіть це повідомлення на диск.

Наступний фрагмент коду показує, як створити завдання з типом закінчення повторення EndAfterNOccurrence.

Наступну функцію можна використати для обчислення кількості подій між двома датами:

Встановлення значення кількості повторень

Наведений фрагмент коду показує, як встановити значення кількості повторень.

Щоденні повторення: тип EndAfterDate

Щоденні повторення: встановлення значення Щодня

Наведений фрагмент коду показує, як встановити значення period у 1 та значення INTERVAL у 1 у рядку RRULE.

Значення Every Day можна встановити у будь‑яке підходяще значення, як показано у наведеному прикладі:

Щоденні повторення: тип NeverEnd

Тип завершення можна встановити за допомогою MapiCalendarRecurrenceEndType.NeverEnd. Параметр Period або INTERVAL можна встановити на потрібне значення, наприклад 1, у наведеному нижче прикладі.

Робота з щотижневими повтореннями

Aspose.Email надає розширені можливості для створення щотижневих повторень за допомогою MapiCalendarWeeklyRecurrencePattern. Можна використовувати три різні типи завершення повторень календаря Mapi, включаючи EndAfterNOccurrences, EndAfterDate та NeverEnd. У цьому розділі демонструється створення різних шаблонів щотижневих повторень.

Щотижневі повторення: тип EndAfterNOccurrences

У цьому типі повторення кількість повторень слід встановити разом з іншою інформацією наступним чином:

Встановіть дату початку, завершення та виконання.
Створити MapiTask.
Встановити стан завдання на НеПризначено.
Створіть об’єкт щотижневого повторення, встановивши властивості, такі як PatternType, Period, WeekStartDay, EndType та OccurenceCount.
Встановіть властивість MapiTask.Recurrence у цей об’єкт щотижневого повторення.
Збережіть це повідомлення на диск.

Наведений фрагмент коду показує, як створити завдання з типом завершення повторення EndAfterNOccurrence.

Наступну функцію можна використати для обчислення кількості подій між двома датами:

Вибір кількох днів у тижні

Наведений фрагмент коду показує, як вибрати кілька днів у тижні.

Вибір кількох днів у тижні та встановлення інтервалів

Наведений фрагмент коду показує, як вибрати кілька днів тижня та встановити інтервали.

Щотижневі повторення: тип EndAfterDate

Щотижневі повторення: встановлення значення Кожен День

Наведений фрагмент коду показує, як встановити значення period у 1 та значення INTERVAL у 1 у рядку RRULE.

Значення Every Day можна встановити у будь‑яке підходяще значення, а кілька днів можна вибрати, як показано у наведеному прикладі:

Щотижневі повторення: тип NeverEnd

Робота з щомісячними повтореннями

Aspose.Email підтримує створення щомісячних повторень за допомогою MapiCalendarMonthlyRecurrencePattern. Можна використовувати три різні типи завершення повторень календаря Mapi, включаючи EndAfterNOccurrences, EndAfterDate та NeverEnd. У цьому розділі демонструється створення різних шаблонів щомісячних повторень.

Місячні повторення: тип EndAfterNOccurrences

У цьому типі повторення кількість повторень слід встановити разом з іншою інформацією наступним чином:

Встановіть дату початку, завершення та виконання.
Створити MapiTask.
Встановити стан завдання на НеПризначено.
Створіть об’єкт щомісячного повторення, встановивши такі властивості, як PatternType, Period, WeekStartDay, EndType та OccurenceCount.
Встановіть властивість MapiTask.Recurrence у цей об’єкт щомісячного повторення.
Збережіть це повідомлення на диск.

Наведений фрагмент коду показує, як створити завдання з типом завершення повторення EndAfterNOccurrence.

Наступну функцію можна використати для обчислення кількості подій між двома датами:

Встановити фіксовану кількість повторень

Наведений фрагмент коду показує, як встановити фіксовану кількість повторень.

Місячні повторення: тип EndAfterDate

"End By" опція у Mapi Task досягається встановленням властивості OccurrenceCount, яка обчислюється функцією GetOccurrenceCount(). Ця функція приймає дату початку, дату закінчення та рядок RRULE. Нижче наведено фрагмент коду, який показує, як створити повторення на 15‑те число кожного місяця між датами початку та закінчення.

Місячні повторення: тип NeverEnd

Наведений фрагмент коду показує, як встановити тип завершення за допомогою MapiCalendarRecurrenceEndType.NeverEnd.

Робота з щорічними повтореннями

Aspose.Email підтримує створення щорічних повторень за допомогою MapiCalendarMonthlyRecurrencePattern. Встановивши властивість period на 12, можна отримати щорічний шаблон повторення. Можна використовувати три різні типи завершення повторень календаря Mapi, включаючи EndAfterNOccurrences, EndAfterDate та NeverEnd. У цьому розділі демонструється створення різних шаблонів щорічних повторень.

Щорічні повторення: тип EndAfterNOccurrences

У цьому типі повторення кількість повторень слід встановити разом з іншою інформацією наступним чином:

Встановіть дату початку, завершення та виконання.
Створити MapiTask.
Встановити стан завдання на НеПризначено.
Створіть об’єкт щомісячного повторення, встановивши такі властивості, як PatternType, Period, WeekStartDay, EndType та OccurenceCount.
Встановіть властивість MapiTask.Recurrence у цей об’єкт щомісячного повторення, щоб отримати щорічне повторення.
Збережіть це повідомлення на диск.

Наведений фрагмент коду показує, як створити завдання з типом завершення повторення EndAfterNOccurrence.

Щорічні повторення: тип EndAfterDate

"End By" опція у Mapi Task досягається встановленням властивості OccurrenceCount, яка обчислюється функцією GetOccurrenceCount(). Ця функція приймає дату початку, дату закінчення та рядок RRULE. Нижче наведено фрагмент коду, який показує, як створити повторення на 15‑те число кожного 7‑го місяця між датами початку та закінчення.

Щорічні повторення: тип NeverEnd

Наведений фрагмент коду показує, як встановити тип завершення за допомогою MapiCalendarRecurrenceEndType.NeverEnd.

Створити повторення з правила повторення

API Aspose.Email забезпечує можливість створювати шаблон повторення з правила повторення (RRULE). Він аналізує інформацію з RRULE відповідно до специфікації iCal RFC 5545 та генерує шаблон повторення за допомогою методу MapiCalendarRecurrencePatternFactory.FromString. Нижче наведено фрагмент коду, який показує, як генерувати шаблон повторення з правила.

Додати вкладення до повторюваних подій календаря

API Aspose.Email надає можливість додавати вкладення до повторюваних подій календаря.