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

Net: Създаване и запазване на Outlook файлове

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

Aspose.Email поддържа създаването на Outlook съобщения (MSG) файлове. Тази статия обяснява как да:

Създаване и запазване на Outlook съобщения

Този 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 файла.

Пишете следния код в събитието click на бутона в Windows приложението.

Създаване на MSG файлове с прикачени файлове

В примера по-горе, създадохме прост MSG файл. Aspose.Email също поддържа запазване на файлове със съобщения с прикачени файлове. Всичко, което трябва да направите, е да добавите прикачените файлове към MailMessage екземпляр. Добавяйте прикачени файлове, като извикате метода Add() върху MailMessage.Attachments колекцията. Добавете ListBox към формата, създадена по-горе, и добавете два бутона – по един за добавяне и премахване на прикачени файлове. Приложението, което добавя прикачени файлове, работи така:

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

Пишете следния код в събитието за кликване на бутона Add Attachment.

Когато бутонът Remove Attachment се натисне, премахнете избраните елементи от ListBox. Пишете следния код в събитието за кликване на бутона Remove Attachment.

Добавете кода за добавяне на прикачените файлове към MailMessage екземпляр. Финалният код за функцията Write Msg е написан както по-долу.

Създаване на MSG файлове с RTF тяло

Можете също така да създавате Outlook съобщения (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 и зададете типа на съдържанието (например plain text, 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);

Try it out!

Конвертирайте имейли и архиви от съобщения онлайн с безплатното Приложение за конвертиране на 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);
}

Try it out!

Парсирайте имейл файлове онлайн безплатно с Приложение за парсване Aspose.Email.

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 съобщения

Aspose.Email API предоставя възможност за конвертиране на MSG файлове към MIME съобщения, като използва ToMailMessage метод.

Задаване на време за изчакване за конвертиране и зареждане на съобщения

Следните функции ще ви позволят да зададете време за изчакване в милисекунди за процеса на конвертиране и зареждане:

MailConversionOptions.Timeout property – Ограничаване на времето в милисекунди при конвертиране на съобщение.
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 class може да се използва за зареждане и четене на Outlook шаблон (OFT) файл. След като шаблонът е зареден в инстанция на MailMessage клас, можете да актуализирате подателя, получателя, съдържанието, темата и други свойства. След актуализиране на свойствата:

Изпратете имейла, като използвате SmtpClient клас или
Запазете съобщението като MSG и извършете допълнителни актуализации/валидиране, използвайки Microsoft Outlook.

В примерите с код по-долу, ние:

Заредете шаблона, като използвате MailMessage клас.
Актуализирайте някои от свойствата.
Запазете съобщението във формат MSG.

Следният фрагмент от код показва как да заредите OFT файл, актуализирате съобщението и го запишете във формат MSG.

Записване на MSG файлове като шаблони

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

Определяне на тип MAPI съобщение (OFT или MSG)

При зареждане на MapiMessage обект от файл, може да се наложи да определите дали зареденият файл е шаблон или обикновен имейл файл. Чрез използване на IsTemplate свойство на MapiMessage class, можете точно да определите дали имейлът е шаблон или не. Тази функционалност може да бъде ценна при обработка и управление на различни типове имейл файлове в приложения и системи.

Примерът с код по-долу демонстрира как да се определи дали 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

Този SaveOptions class позволява да зададете допълнителни опции при запазване на 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 store‑ове подходящ сертификат и частен ключ).
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 и низа на цветова категория, например "Purple Category" или "Red Category", като аргументи.
RemoveCategory приема MapiMessage и низът на цветова категория, който да се премахне от съобщението.
ClearCategories се използва за премахване на всички цветови категории от съобщението.
GetCategories се използва за извличане на всички цветови категории от конкретно съобщение.

Следният пример изпълнява задачите, както е дадено по-долу:

Добавете цветова категория.
Добавете още една цветова категория.
Получете списъка с всички категории.
Премахнете всички категории.

Достъп до информация за последващи действия в MSG файлове

Aspose.Email API предоставя възможност за достъп до информацията за проследяване от изпратено или получено съобщение. Тя може да извлича информация за разписка за прочитане, разписка за доставка и резултати от гласуване от файл със съобщение.

Получаване на информация за получени и доставени разписки

Следният кодов фрагмент показва как да извлечете информация за разписка за прочитане и доставка.

Създаване на съобщения за препращане и отговор

Aspose.Email API предоставя възможност за създаване и форматиране на съобщения за препращане и отговор. ReplyMessageBuilder и ForwardMessageBuilder класовете на API се използват за създаване съответно на Reply и Forward съобщения. Reply или Forward съобщение може да бъде създадено, използвайки който и да е от режимите на OriginalMessageAdditionMode enum. Този enum има следните стойности:

OriginalMessageAdditionMode.None – Оригиналното съобщение не е включено в отговорното съобщение.
OriginalMessageAdditionMode.Attachment – Оригиналното съобщение е включено като прикачен файл в отговорното съобщение
OriginalMessageAdditionMode.Textpart – Оригиналното съобщение се включва като текст в тялото на отговорното съобщение

Създаване на съобщения с отговор

Следният кодов отрязък показва как да създадете съобщение с отговор.

Създаване на съобщения за препращане

Следният кодов фрагмент показва как да създадете съобщение за препращане.

Net: Използване на Aspose Outlook Control за плъзгане и пускане на 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 форма:

Добавете обработчик на събитие за 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 клас предоставя 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, можете да използвате 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

Този 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

Задаване на последващи действия и крайни дати за MSG файлове

Флагът за последващи действия маркира имейл съобщение за определено действие. Microsoft Outlook позволява на потребителите да маркират съобщения с флаг и, при настройка на флага, да зададат крайна дата за последващи действия. Microsoft Outlook изпраща напомняне до получателя, за да го подтикне да следи имейла. Програмирането на маркиране на имейли с флаг и задаване на крайни дати позволява на софтуерните разработчици да автоматизират определени типове имейли и да помогнат на получателите да помнят да предприемат действие. Например, това може да се използва за изпращане на месечни съобщения до продажбения екип, за да ги напомни да завършат докладите си; или за изпращане на съобщение до целия персонал, за да ги напомни за фирмена среща. Aspose.Email за .NET поддържа задаване на флаг за последващи действия и крайна дата за MapiMessage обекти, използващи FollowUpManager и FollowUpOptions. Съществуват различни варианти, по които флагът за последващи действия може да бъде зададен за съобщение. Всички те се използват в следващия пример с код:

Задай флаг за проследяване на съобщение
Добави дата за изпълнение и дата за напомняне към съобщение
Добави флаг към съобщението на получателя.
Маркирай като завършено.
Премахни флага.
Прочетете опциите за последващо действие.

Задаване на флагове за последващи действия

Следният кодов фрагмент показва как да зададете флаг за последващо действие.

Задаване на последващи действия за получатели

Следният кодов фрагмент показва как да зададете последващо действие за получателите.

Маркиране на флаговете за последващи действия като завършени

Следният кодов фрагмент показва как да маркирате флага за последващо действие като завършен.

Премахване на флаговете за последващи действия

Следният кодов фрагмент показва как да премахнете флага за последващо действие.

Четене на опции за флаг за последващи действия

Следният кодов фрагмент показва как да прочетете опциите за флага на последващо действие за съобщение.

Net: Работа с MAPI свойства

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

Достъп и задаване на Outlook MAPI свойство

Този MapiProperty клас, представляващ MAPI свойство, което съдържа:

Name: низ, представляващ името на свойството.
Tag: стойност от тип long, представляваща тага на свойството.
Data: масив от байтове, представляващ свойството данни.

Получаване на MAPI свойства чрез Property Tags

За получаване на MAPI свойства:

Създайте инстанция на MapiMessage от зареждане от файлове или поток.
Получете MapiProperty от MapiMessage.Properties от 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 клас Прикачени файлове свойство. The Прикачени файлове свойството е колекция от тип 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)

Този 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 клас Колекция от прикачени файлове. Следният примерен код анализира файл със съобщение за вградени прикачени съобщения и го запазва на диска. The MapiMessage статичният метод FromProperties() на класа може да създаде ново съобщение от вграден прикачен файл. Следният кодов фрагмент показва как да получите вложени прикачени файлове на имейл съобщения.

Премахване на прикачени файлове

Библиотеката Aspose Outlook предоставя функционалност за премахване на прикачени файлове от Microsoft Outlook съобщения (.msg) файлове:

Извикайте метода RemoveAttachments(). Той приема пътя към файла на съобщението като параметър. Той е реализиран като публичен статичен метод, така че не е необходимо да създавате инстанция на обекта.

Следният кодов отрязък ви показва как да премахнете прикачени файлове.

Можете също да извикате MapiMessage статичен метод на класа DestroyAttachment(). Работи по-бързо от RemoveAttachment(), тъй като методът RemoveAttachment() анализира файла със съобщението.

Добавяне на MSG прикачени файлове

Outlook съобщение може да съдържа други Microsoft Outlook съобщения като прикачени файлове, било то като обикновени или вградени съобщения. The MapiAttachmentCollection предоставя претоварени членове на метода Add за създаване на Outlook съобщения и с двата типа прикачени файлове.

Try it out!

Добавяйте или премахвайте имейл прикачени файлове с безплатния Aspose.Email Editor App.

Добавяне на референтни прикачени файлове към MapiMessages

Този 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 предоставя възможност за вмъкване на прикачени файлове на конкретен индекс в родителското съобщение. Тя също предоставя възможност за замяна съдържанието на прикачен файл с друг прикачен файл от съобщение.

Try it out!

Изпълнете ReplaceAttach прост проект за приложение, и пробвайте възможностите на Aspose.Email за замяна на прикачени файлове в действие.

Вмъкване на прикачени файлове на конкретни места

Aspose.Email API предоставя възможността да вмъкнете MSG прикачен файл в родителски MSG, като използвате метода Insert на MapiAttachmentCollection – MapiAttachmentCollection Insert(int index, string name, MapiMessage msg). Следният кодов фрагмент показва как да вмъкнете прикачен файл на конкретно място.

Замяна на съдържанието на прикачения файл

Това може да се използва за замяна на съдържанието на вградените прикачени файлове с нови, като се използва методът Replace. Въпреки това, не може да се използва за вмъкване на прикачен файл с PR_ATTACH_NUM = 4 (например) в колекция, чийто 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 контакти. The 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 контакти

Този MapiContact класът може да се използва за зареждане както на Outlook MSG, така и на VCard формат контакти. Следният кодов откъс показва как да заредите Outlook контакти, запазени като MSG и VCF, в a MapiContact.

Зареждане на контакти от MSG файлове

Следният кодов откъс показва как да заредите контакти от MSG.

Зареждане на контакти от VCard файлове

Следният кодов откъс показва как да заредите контакти от VCard.

Зареждане на MAPI контакти от vCard с персонализирани опции

За да предостави повече гъвкавост при конвертиране на VCard (.vcf) файлове в MAPI контакти, Aspose.Email за .NET предлага претоварен метод MapiContact.FromVCard(string filePath, VCardLoadOptions options) метод, който приема a VCardLoadOptions обект. Той предлага подобрен контрол върху начина, по който се интерпретират VCard файловете – особено при работа с различни VCard формати, кодирания или сложни сценарии за парсиране.

Следният примерен код демонстрира как да се зареди .vcf файл с контакти в a MapiContact обект, използвайки претоварения метод, който приема VCardLoadOptions. Зареденият контакт може след това да се използва в PST файлове, при експорт в MSG или в други формати, съвместими с Outlook.

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

Зареждане на контакти от VCard файлове със зададено кодиране

Следният кодов откъс показва как да заредите контакти от VCard със зададено кодиране.

Записване на VCard контакти със зададено кодиране

Персонализирайте поведението при запазване на VCard файлове, използвайки VCardSaveOptions клас. Този PreferredTextEncoding свойството на класа ще зададе кодирането, което да се използва при запазване на VCard контакти.

Следният пример с код показва как да реализирате това свойство във вашия проект:

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

Записване на VCard файлове с разширени полета

Този 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 контакти асинхронно

Този 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, използвайки Aspose.Email API. Този пример показва как 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

Възможно е да създадете списък за разпращане (Distribution list) с помощта на Aspose.Email API, който е колекция от множество контакти. Списъкът за разпращане може да бъде записан на диск във формат Outlook MSG и може да се преглежда/манипулира, като се отвори в MS Outlook.

Създаване и запазване на дистрибуционни списъци

Следният фрагмент от код показва как да създадете и запазите дистрибуционен списък.

Четене на дистрибуционни списъци от PST файлове

Следният фрагмент от код показва как да прочетете дистрибуционен списък от PST файл.

Net: Създаване, запазване и четене на Outlook задачи

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

Създаване на Outlook задачи

Aspose.Email за .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 със запазени полета на задачи

Този 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

Създаване и запазване на Outlook бележки

Aspose.Email предоставя възможност за създаване на Outlook бележки и запазването им на диск във формат MSG. MapiNote класът предоставя свойства и методи за задаване на информация за задача. Тази статия показва как да създадете, запазите и прочетете MapiNote от диска.

Следните стъпки могат да се използват за създаване и запазване на бележка на диск:

Инстанцирайте обект от MapiNote клас.
Задайте различни свойства.
Запазете бележката на диск като MSG файл.

Следният кодов отрязък показва как да създадете и запазите Outlook бележка.

Четене на MAPI бележки

Този MapiNote обект от клас се използва за привеждане на MapiMessage обект, който зарежда бележка от диск във формат MSG. Следният кодов отрязък показва как да прочетете MapiNote.

Net: Управление на елементи от календар в Outlook

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

Aspose.Email MapiCalendar класът предоставя методи и атрибути за задаване на различни свойства на календарен елемент. Този раздел предоставя примерен код за:

Създаване и запазване на елементи от календар

Следният кодов фрагмент показва как да създадете и запазите календарен елемент във формат ICS.

Записване на календарни елементи като MSG файлове

Следният кодов фрагмент показва как да запазите календарния елемент като MSG.

Записване на идентификатори на продукти за MAPI календарни елементи в ICS

Този 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 календар TimeZone от стандартна часова зона

Следният фрагмент от код показва как да създадете 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 календарни елементи

Задайте състоянието на MAPI календарен обект изрично, като надмине стандартното поведение. Това позволява по-добър контрол върху състоянията на календарните събития, особено при обработка на получени заявки за среща. По подразбиране, когато се създаде среща, нейното състояние е 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: Управление на повторения

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

Работа с дневни повторения

Aspose.Email поддържа създаване на дневни повторения, използвайки MapiCalendarDailyRecurrencePattern. Могат да се използват три различни типа край за повторения в Mapi календар, включително EndAfterNOccurrences, EndAfterDate и NeverEnd. Този раздел демонстрира създаването на различни модели на дневни повторения.

Дневни повторения с брой на поява

При този тип повтаряне броят на повторенията трябва да се зададе заедно с останалата информация, както следва:

Задайте начална, крайна и дата на изпълнение.
Създайте MapiTask.
Задайте състоянието на задачата на NotAssigned.
Създайте дневния обект за повторение, като зададете свойства като PatternType, Period, WeekStartDay, EndType и OccurenceCount.
Задайте свойството MapiTask.Recurrence на този дневен обект за повторение.
Запазете това съобщение на диска.

Следният кодов откъс показва как да се създаде задача с тип на край на повторение EndAfterNOccurrence.

Следната функция може да се използва за изчисляване на броя събития между двете дати:

Задаване на стойността за брой повторения

Следният фрагмент от код показва как да зададете стойността за брой повторения.

Дневни повтаряния: тип EndAfterDate

Дневни повторения: Настройване на стойността Every Day

Следният фрагмент от код показва как също да зададете стойността period на 1 и стойността INTERVAL на 1 в RRULE низа.

Стойността Every Day може да се зададе на всяка подходяща стойност, както е показано в следния пример:

Дневни повтаряния: тип NeverEnd

Типът на края може да се зададе, като се използва MapiCalendarRecurrenceEndType.NeverEnd. Периодът или INTERVAL могат да се зададат на необходимата стойност, например 1, в следния пример.

Работа със седмични повторения

Aspose.Email предоставя богати функции за създаване на седмични повторения, използвайки MapiCalendarWeeklyRecurrencePattern. Три различни типа край за повторения в Mapi календар могат да се използват, включително EndAfterNOccurrences, EndAfterDate и NeverEnd. Този раздел демонстрира създаването на различни модели на седмични повторения.

Седмични повтаряния: тип EndAfterNOccurrences

Задайте начална, крайна и дата на изпълнение.
Създайте MapiTask.
Задайте състоянието на задачата на NotAssigned.
Създайте обекта за седмично повторение, като зададете свойства като PatternType, Period, WeekStartDay, EndType и OccurenceCount.
Задайте свойството MapiTask.Recurrence на този обект за седмично повторение.
Запазете това съобщение на диска.

Следният фрагмент от код показва как да създадете задача с тип край на повторението EndAfterNOccurrence.

Следната функция може да се използва за изчисляване на броя събития между двете дати:

Избиране на множество дни в седмицата

Следният фрагмент от код показва как да изберете множество дни в седмицата.

Избиране на множество дни в седмицата и задаване на интервали

Следният фрагмент от код показва как да изберете множество дни в седмицата и да зададете интервали.

Седмични повтаряния: тип EndAfterDate

Седмични повторения: Настройване на стойността Every Day

Следният фрагмент от код показва как също да зададете стойността period на 1 и стойността INTERVAL на 1 в RRULE низа.

Стойността Every Day може да се зададе на всяка подходяща стойност и могат да се изберат множество дни, както е показано в следния пример:

Седмични повтаряния: тип NeverEnd

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

Aspose.Email поддържа създаване на месечни повторения, използвайки MapiCalendarMonthlyRecurrencePattern. Три различни типа край за повторения в Mapi календар могат да се използват, включително EndAfterNOccurrences, EndAfterDate и NeverEnd. Този раздел демонстрира създаването на различни модели на месечни повторения.

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

Задайте начална, крайна и дата на изпълнение.
Създайте MapiTask.
Задайте състоянието на задачата на NotAssigned.
Създайте обекта за месечно повторение, като зададете свойства като 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.
Задайте състоянието на задачата на NotAssigned.
Създайте обекта за месечно повторение, като зададете свойства като 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 според спецификацията RFC 5545 iCal и генерира модела на повторение, използвайки метода MapiCalendarRecurrencePatternFactory.FromString. Следният фрагмент от код показва как да генерирате модел на повторение от правило за повторение.

Добавяне на прикачен файл към повтарящи се събития в календара

Aspose.Email API предоставя възможност за добавяне на прикачени файлове към повтарящи се събития в календара.