Documentation – Ръководство за разработчици

Net: Изпращане на имейл съобщения чрез MailGun и SendGrid

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

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

Първо, важно е да настроите опциите в зависимост от услугата, която ще се използва за изпращане на съобщения. DeliveryServiceOptions клас ще ви помогне с това. Следният кодов пример показва как да настроите опциите за услугите.

MailGun опциите на клиента:

string domain = "YOUR_MAILGUN_DOMEN";
string privApiKey = "YOUR_MAILGUN_PRIVATE_API_KEY";
var opt = new MailgunClientOptions { Domain = domain, ApiKey = privApiKey };

SendGrid опциите на клиента:

string privApiKey = "YOUR_SENDGRID_PRIVATE_API_KEY";
var opt = new SendGridClientOptions { ApiKey = privApiKey };

За подготовка и изпращане на съобщение, използвайте следния кодов пример и стъпки:

Създайте инстанция на IDeliveryServiceClient интерфейс.
Създайте ново eml съобщение, използвайки MailMessage клас. Посочете неговите свойства.
Използвайте Изпрати метод на обекта client за изпращане на имейл. Резултатът от операцията по изпращане се съхранява в променливата resp.
Ако операцията по изпращане не е била успешна (resp.Successful е false), кодът влиза в foreach цикъл, за да обходи колекцията ErrorMessages на обекта resp. Всяко съобщение за грешка се отпечатва в конзолата с Console.WriteLine.

IDeliveryServiceClient client = DeliveryServiceClientFactory.Get(opt);

MailMessage eml = new MailMessage(fromAddress, toAddress, subject, body);

var resp = client.Send(eml);

if (!resp.Successful)
{
    foreach (var error in resp.ErrorMessages)
    {
        Console.WriteLine(error);
    }
}

Изпращане на съобщения асинхронно

MailMessage eml = new MailMessage(fromAddress, toAddress, subject, body);

var sendTask = client.SendAsync(eml);
sendTask.Wait();

if (!sendTask.Result.Successful)
{
    foreach (var error in sendTask.Result.ErrorMessages)
    {
        Console.WriteLine(error);
    }
}

Настройване на персонализиран базов URL за SendGrid

Конфигурирайте базовия URL за SendGrid клиента, използвайки SendGridRegion изброяване и свойства в SendGridClientOptions клас. Тази функция позволява на разработчиците да зададат желан регион за SendGrid, като например EU или глобалния регион по подразбиране, осигурявайки оптимална производителност и съответствие с регионалните изисквания. Следният кодов пример демонстрира как да се конфигурира SendGridClientOptions за използване на EU регион на SendGrid. Настройването на базовия URL помага да се съгласува с местоживеенето на данните и предпочитанията за латентност.

SendGridClientOptions opt = new SendGridClientOptions() 
{ 
    ApiKey = "YourApiKey", 
    Region = SendGridRegion.EU 
};
IDeliveryServiceClient client = DeliveryServiceClientFactory.Get(opt);
client.EndPoint = "https://api.eu.sendgrid.com";

Net: Работа с MIME съобщения

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

Net: Управление на назначения: създаване & манипулиране, конвертиране на ICS в MSG

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

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

Този Appointment клас в Aspose.Email за .NET може да се използва за създаване на ново назначение. В тази статия първо създаваме назначение и го запазваме на диск във формат ICS. Следните стъпки са необходими за създаване на назначение и запазването му на диск.

Създайте инстанция на Appointment клас и го инициализирайте с този конструктор.
Предайте следните аргументи в горния конструктор
1. Местоположение
2. Резюме
3. Описание
4. Начална дата
5. Крайна дата
6. Организатор
7. Участници
Извикайте Save() метод и задайте името на файла и формата в аргументите.

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

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

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

// Create and initialize an instance of the Appointment class
Appointment appointment = new Appointment(
    "Meeting Room 3 at Office Headquarters",// Location
    "Monthly Meeting",                      // Summary
    "Please confirm your availability.",    // Description
    new DateTime(2015, 2, 8, 13, 0, 0),     // Start date
    new DateTime(2015, 2, 8, 14, 0, 0),     // End date
    "from@domain.com",                      // Organizer
    "attendees@domain.com");                // Attendees

// Save the appointment to disk in ICS format            
appointment.Save(fileName + ".ics", new AppointmentIcsSaveOptions());
Console.WriteLine("Appointment created and saved to disk successfully.");

// Save the appointment to disk in MSG format
appointment.Save(fileName + ".msg", new AppointmentMsgSaveOptions(););
Console.WriteLine("Appointment created and saved to disk successfully.");

Създаване на среща с HTML съдържание

Можете да зададете алтернативни представяния на описанието на събитието в различни типове съдържание, използвайки заглавката X-ALT-DESC. Тя позволява на получателите на iCalendar файла да изберат представянето, което най‑добре отговаря на техните нужди. Например, можете да включите описание в чист текст с тип съдържание "text/plain" и HTML описание с тип съдържание "text/html". Заглавката X-ALT-DESC се добавя за всяко алтернативно представяне. За да създадете назначение с HTML съдържание, задайте HtmlDescription свойство.

Изпробвайте следния пример с код, за да създадете назначение с алтернативно HTML описание:

Създайте нов екземпляр на класа Appointment.
Предоставете необходимите параметри на конструктора на Appointment:
- Укажете мястото на назначението.
- Задайте датата и часа на започване.
- Задайте датата и часа на края.
- Укажете организатора.
- Укажете участника.
Задайте HtmlDescription свойство на обекта за назначение, указващо, че описанието е във HTML формат.
Задайте свойството Description на обекта за назначение със стойност, форматирана като HTML, оградена в многоредов низ:
- HTML маркировката включва блок <style>, който дефинира CSS клас с име "text" със стилове за шрифт.
- Тялото на HTML съдържа елемент <p> с CSS клас "text" и реалното съобщение за покана.
Обектът за назначение вече е готов и можете да извършвате допълнителни операции или да го запазите като iCalendar файл.

var appointment = new Appointment("Bygget 83",
    DateTime.UtcNow, // start date
    DateTime.UtcNow.AddHours(1), // end date
    new MailAddress("TintinStrom@from.com", "Tintin Strom"), // organizer
    new MailAddress("AinaMartensson@to.com", "Aina Martensson")) // attendee
{
    HtmlDescription = @"
    <html>
     <style type=""text/css"">
      .text {
             font-family:'Comic Sans MS';
             font-size:16px;
            }
     </style>
    <body>
     <p class=""text"">Hi, I'm happy to invite you to our party.</p>
    </body>
    </html>"
};

Създаване на заявка за чернова на среща

В нашите предишни статии беше показано как да създадем и запазим назначение във формат ICS. Често е необходимо да се създаде заявка за назначение в режим Чернова, така че основната информация да бъде добавена и след това същата чернова да се препрати към други потребители за необходимите промени според индивидуалните нужди. За да запазите назначение в режим Чернова, MethodType свойството на класа Appointment трябва да бъде зададено на AppointmentMethodType.Publish. Следният фрагмент от код показва как да създадете чернова на заявка за назначение.

string sender = "test@gmail.com";
string recipient = "test@email.com";

MailMessage message = new MailMessage(sender, recipient, string.Empty, string.Empty);

Appointment app = new Appointment(string.Empty, DateTime.Now, DateTime.Now, sender, recipient)
{
    MethodType = AppointmentMethodType.Publish
};

message.AddAlternateView(app.RequestApointment());

MapiMessage msg = MapiMessage.FromMailMessage(message);

// Save the appointment as draft.
msg.Save(dstDraft);

Console.WriteLine(Environment.NewLine + "Draft saved at " + dstDraft);

Създаване на чернова на среща от текст

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

string ical = @"BEGIN:VCALENDAR
METHOD:PUBLISH
PRODID:-//Aspose Ltd//iCalender Builder (v3.0)//EN
VERSION:2.0
BEGIN:VEVENT
ATTENDEE;CN=test@gmail.com:mailto:test@gmail.com
DTSTART:20130220T171439
DTEND:20130220T174439
DTSTAMP:20130220T161439Z
END:VEVENT
END:VCALENDAR";

string sender = "test@gmail.com";
string recipient = "test@email.com";
MailMessage message = new MailMessage(sender, recipient, string.Empty, string.Empty);
AlternateView av = AlternateView.CreateAlternateViewFromString(ical, new ContentType("text/calendar"));
message.AlternateViews.Add(av);
MapiMessage msg = MapiMessage.FromMailMessage(message);
msg.Save(dataDir + "draft_out.msg");

Персонализиране на назначения

Задаване на статус на участниците в срещата

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

DateTime startDate = new DateTime(2011, 12, 10, 10, 12, 11),
         endDate = new DateTime(2012, 11, 13, 13, 11, 12);
MailAddress organizer = new MailAddress("aaa@amail.com", "Organizer");
MailAddressCollection attendees = new MailAddressCollection();
MailAddress attendee1 = new MailAddress("bbb@bmail.com", "First attendee");
MailAddress attendee2 = new MailAddress("ccc@cmail.com", "Second attendee");

attendee1.ParticipationStatus = ParticipationStatus.Accepted;
attendee2.ParticipationStatus = ParticipationStatus.Declined;
attendees.Add(attendee1);
attendees.Add(attendee2);

Appointment target = new Appointment(location, startDate, endDate, organizer, attendees);

Персонализиране на идентификатора на продукта за iCalendar

Aspose.Email за .NET API позволява получаване или задаване на идентификатора на продукта, който е създал iCalendar обекта.

string description = "Test Description";
Appointment app = new Appointment("location", "test appointment", description, DateTime.Today,
DateTime.Today.AddDays(1), "first@test.com", "second@test.com");

IcsSaveOptions saveOptions = IcsSaveOptions.Default;
saveOptions.ProductId = "Test Corporation";
app.Save(dataDir + "ChangeProdIdOfICS.ics", saveOptions);

Зареждане на назначения

Също така, Appointment класът може да се използва за зареждане на назначение от ICS файл.

Зареждане на среща във формат ICS

За да заредите среща във формат ICS, необходимите стъпки са следните:

Създайте инстанция на Appointment клас.
Извикайте Load() метод чрез предоставяне на пътя до файла ICS.
Прочетете всяко свойство, за да получите информация от назначението (ICS файл).

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

// Load an Appointment just created and saved to disk and display its details.
Appointment loadedAppointment = Appointment.Load(dstEmail);
Console.WriteLine(Environment.NewLine + "Loaded Appointment details are as follows:");
// Display the appointment information on screen
Console.WriteLine("Summary: " + loadedAppointment.Summary);
Console.WriteLine("Location: " + loadedAppointment.Location);
Console.WriteLine("Description: " + loadedAppointment.Description);
Console.WriteLine("Start date: " + loadedAppointment.StartDate);
Console.WriteLine("End date: " + loadedAppointment.EndDate);
Console.WriteLine("Organizer: " + appointment.Organizer);
Console.WriteLine("Attendees: " + appointment.Attendees);
Console.WriteLine(Environment.NewLine + "Appointment loaded successfully from " + dstEmail);

Конвертиране на ICS в MSG

API‑то позволява лесно да конвертирате назначение в обект съобщение. Следният пример с код показва как да конвертирате заявка за назначение в MailMessage или MapiMessage:

var appointment = Appointment.Load("appRequest.ics");

var eml = appointment.ToMailMessage();
var msg = appointment.ToMapiMessage();

Четене на множество събития от ICS файл

List<Appointment> appointments = new List<Appointment>();
CalendarReader reader = new CalendarReader(dataDir + "US-Holidays.ics");

while (reader.NextEvent())
{
    appointments.Add(reader.Current);
}
//working with appointments...

Записване на множество събития в ICS файл

IcsSaveOptions saveOptions = new IcsSaveOptions();
saveOptions.Action = AppointmentAction.Create;
using (CalendarWriter writer = new CalendarWriter(dataDir + "WriteMultipleEventsToICS_out.ics", saveOptions))
{
    for (int i = 0; i < 10; i++)
    {
        Appointment app = new Appointment(string.Empty, DateTime.Now, DateTime.Now, "sender@domain.com", "receiver@domain.com");
        app.Description = "Test body " + i;
        app.Summary = "Test summary:" + i;
        writer.Write(app);
    }
}

Определяне на версията на назначението

За да определите версията на назначение, можете да използвате Appointment.Version свойство на Appointment клас. Това свойство помага да определите върху коя версия са базирани техните файлове, осигурявайки интеграция с други системи и приложения.

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

var app = Appointment.Load("meeting.ics");

if (app.Version == 1.0)
{
    // do something
}

Net: Работа с Outlook елементи

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

Net: Работа с Outlook файлове за хранилище

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

Net: Работа с SMTP клиент

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

Net: Работа с POP3 клиент

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

Net: Работа с IMAP клиент

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

Net: Работа с Exchange EWS клиент

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

Net: Работа с Microsoft Graph клиент

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

Net: Работа с Exchange WebDav клиент

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

Net: Програмиране с Gmail

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

Net: Как да четете и конвертирате Thunderbird MBOX файлове в .NET

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

Net: Програмиране с Thunderbird

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

Четене на MBOX файлове

Mozilla Thunderbird е отворен код, крос‑платформен имейл клиент, разработен от Mozilla Foundation. Той съхранява имейли в собствена файловата структура, управлявайки индекси на съобщения и подпапки чрез проприетарни файлови формати. Aspose.Email може да работи със структури на хранилището на Thunderbird. MboxrdStorageReader класът позволява на разработчиците да четат съобщения от файл за пощенско хранилище на Mozilla Thunderbird. Тази статия показва как да се четат съобщенията от пощенското хранилище на Thunderbird:

Отворете файла за хранилището на Thunderbird в FileStream.
Създайте инстанция на MboxrdStorageReader клас и предайте горния поток на конструктора.
Извикайте ReadNextMessage() за да получите първото съобщение.
Използвайте същото ReadNextMessage() в while цикъл, за да прочетете всички съобщения.
Затворете всички потоци.

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

// The path to the File directory.
var dataDir = RunExamples.GetDataDir_Thunderbird();

// Open the storage file with FileStream
var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read);
// Create an instance of the MboxrdStorageReader class and pass the stream
var reader = new MboxrdStorageReader(stream, false);
// Start reading messages
var message = reader.ReadNextMessage();

// Read all messages in a loop
while (message != null)
{
    // Manipulate message - show contents
    Console.WriteLine("Subject: " + message.Subject);
    // Save this message in EML or MSG format
    message.Save(message.Subject + ".eml", SaveOptions.DefaultEml);
    message.Save(message.Subject + ".msg", SaveOptions.DefaultMsgUnicode);

    // Get the next message
    message = reader.ReadNextMessage();
}

// Close the streams
reader.Dispose();
stream.Close();

Извличане на свойства на съобщението

MboxMessageInfo класът съдържа следните свойства за извличане на информация за съобщение:

DateTime Date - Получава датата на съобщението
MailAddress From - Получава адреса на подателя
string Subject - Получава темата на съобщението
MailAddressCollection Към - Получава колекцията от адреси, съдържаща получателите на съобщението
MailAddressCollection CC - Получава колекцията от адреси, съдържаща CC получатели
MailAddressCollection Bcc - Получава колекцията от адреси, съдържаща BCC получатели на съобщението

MboxStorageReader reader = MboxStorageReader.CreateReader(fileName, new MboxLoadOptions());

foreach (var mboxMessageInfo in reader.EnumerateMessageInfo())
{
    Console.Writeline($"Subject: {mboxMessageInfo.Subject}");
    Console.Writeline($"Date: {mboxMessageInfo.Date}");
    Console.Writeline($"From: {mboxMessageInfo.From}");
    Console.Writeline($"To: {mboxMessageInfo.To}");
    Console.Writeline($"CC: {mboxMessageInfo.CC}");
    Console.Writeline($"Bcc: {mboxMessageInfo.Bcc}");
}

Извличане на съобщения от MBOX по идентификатори

Този MboxStorageReader класът включва EnumerateMessageInfo() метод, който ви позволява да итерирате през всяко съобщение в MBOX файл. Чрез използване на този метод е възможно да се извлекат отделни съобщения без необходимостта да се обхожда цялото хранилище многократно. Това подобрява производителността и намалява времето за обработка.

Този MboxMessageInfo клас предоставя EntryId свойство, което предоставя достъп до уникални идентификатори за всяко съобщение в MBOX файла. Този идентификатор може да бъде съхранен в база данни или използван като справка за бързо намиране и извличане на конкретни съобщения при нужда.

Този ExtractMessage(string id) метод в MboxStorageReader класът позволява на разработчиците да извличат съобщения въз основа на техния уникален EntryId. Със ExtractMessage(string id) метод, можете да използвате съхранения EntryId, за да извлечете съответното съобщение и да извършите допълнителни операции с него.

Следният пример с код демонстрира как да извлечете съобщения от MBOX файл, използвайки идентификатори:

MboxStorageReader reader = MboxStorageReader.CreateReader("my.mbox", new MboxLoadOptions());

foreach (MboxMessageInfo msgInfo in reader.EnumerateMessageInfo())
{
    MailMessage eml = reader.ExtractMessage(msgInfo.EntryId, new EmlLoadOptions());
}

Конфигуриране на опциите за зареждане при четене на съобщения от MBOX

Следните свойства ще ви позволят да зададете различни опции, свързани със зареждането и обработката на съобщенията:

Свойство MailStorageConverter.MboxMessageOptions – получава или задава опции за зареждане на имейл при парсиране на Mbox хранилище.
Метод MboxrdStorageReader.ReadNextMessage(EmlLoadOptions options) – параметърът EmlLoadOptions определя опциите при четене на съобщение от Mbox хранилище.

var reader = new MboxrdStorageReader(fileName, new MboxLoadOptions());
// Read messages preserving tnef attachments.
var eml = reader.ReadNextMessage(new EmlLoadOptions {PreserveTnefAttachments = true});
MailStorageConverter.MboxMessageOptions(new EmlLoadOptions {PreserveTnefAttachments = true});
// Convert messages from mbox to pst preserving tnef attachments.
var pst = MailStorageConverter.mboxToPst("Input.mbox", "Output.pst");

Задаване на предпочитано текстово кодиране при зареждане на Mbox файлове за четене

Опцията за кодиране е налична за класа MboxrdStorageReader. Тя предоставя допълнителни възможности за зареждане на mbox файл и гарантира, че съобщенията с кодираното съдържание ще бъдат правилно прочетени и обработени. Следният фрагмент от код показва как можете да зададете текстово кодиране, което отговаря на вашите нужди:

var reader = new MboxrdStorageReader("sample.mbox", new MboxLoadOptions() { PreferredTextEncoding = Encoding.UTF8});
var message = reader.ReadNextMessage();

Получаване на общия брой съобщения от MBOX файл

Този MboxrdStorageReader класът предоставя възможност за четене на броя налични елементи в MBox файл. Това може да се използва за разработване на приложения, показващи напредъка на активността при обработка на такъв файл.

// The path to the File directory.
var dataDir = RunExamples.GetDataDir_Thunderbird();

using (var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read))
using (var reader = new MboxrdStorageReader(stream, false))
{
    Console.WriteLine("Total number of messages in Mbox file: " + reader.GetTotalItemsCount());
}

Получете текущия размер на съобщението

using (var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read))
using (var reader = new MboxrdStorageReader(stream, false))
{
    MailMessage msg;
    while ((msg = reader.ReadNextMessage()) != null)
    {
        long currentDataSize = reader.CurrentDataSize;

        msg.Dispose();
    }
}

Конвертиране на MBOX към PST със запазване или премахване на подпис

За да премахнете подписа от файл по време на процеса на конвертиране, задайте MboxToPstConversionOptions.RemoveSignature свойството на true.

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

var pstDataStream = new MemoryStream();
var personalStorage = PersonalStorage.Create(pstDataStream, FileFormatVersion.Unicode);
MailStorageConverter.MboxToPst(new MboxrdStorageReader(new FileStream(fileName, FileMode.Open, FileAccess.Read), new MboxLoadOptions()),
personalStorage,
    "Inbox",
new MboxToPstConversionOptions() { RemoveSignature = true });

Записване на MBOX файлове

Този MboxrdStorageWriter класът предоставя възможност за записване на нови съобщения във файл за пощенско хранилище на Thunderbird. За записване на съобщения:

Отворете файла за хранилището на Thunderbird в FileStream.
Създайте инстанция на MboxrdStorageWriter клас и предайте горния поток на конструктора.
Подгответе ново съобщение, като използвате MailMessage клас.
Извикайте WriteMessage() метод и предайте горното MailMessage инстанция за добавяне на съобщението към хранилището на Thunderbird.
Затворете всички потоци.

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

// Open the storage file with FileStream
var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Write);

// Initialize MboxStorageWriter and pass the above stream to it
var writer = new MboxrdStorageWriter(stream, false);
// Prepare a new message using the MailMessage class
var message = new MailMessage("from@domain.com", "to@domain.com", Guid.NewGuid().ToString(), "added from Aspose.Email");
message.IsDraft = false;
// Add this message to storage
writer.WriteMessage(message);
// Close all related streams
writer.Dispose();
stream.Close();

Разделяне на MBOX хранилище/Отмяна на операцията по разделяне

Aspose.Email предоставя методи за разделяне на Mbox хранилището на по-малки части, което улеснява работата с големи архиви от имейли. В зависимост от .NET версията, която използвате, наличните методи и техните параметри могат да се различават. По-долу са методите на MboxStorageReader клас, използван както за версии .NET Framework 4.5 и .NET Core, така и за версии под 4.5.

Членове за версии .NET Framework 4.5 и .NET Core:

SplitInto(long chunkSize, string outputPath, CancellationToken token) - Разделя Mbox хранилището на по-малки части въз основа на зададения размер на частта.
Параметри:
- chunkSize: Приблизителният размер на всяка част в байтове.
- outputPath: Пътят до папката, където ще бъдат създадени частите.
- token: CancellationToken, който позволява възможно отменяне на операцията.
SplitInto(long chunkSize, string outputPath, string partFileNamePrefix, CancellationToken token) - Разделя Mbox хранилището на по-малки части с указан префикс за името на файла за всяка част.
Параметри:
- chunkSize: Приблизителният размер на всяка част в байтове.
- outputPath: Пътят до папката, където ще бъдат създадени частите.
- partFileNamePrefix: Префикс, който да се добави към името на файла на всяка част.
- token: CancellationToken, който позволява възможно отменяне на операцията.

Членове за версии на .NET Framework под 4.5:

SplitInto(long chunkSize, string outputPath) - Разделя Mbox хранилището на по-малки части въз основа на зададения размер на частта.
SplitInto(long chunkSize, string outputPath, string partFileNamePrefix) - Разделя Mbox хранилището на по-малки части с указан префикс за името на файла за всяка част.
Cancel() - Прекъсва текуща операция по разделяне.

Следните кодови примери демонстрират как да разделите MBOX файл на части, като процесът се ограничи до максимум пет части, използвайки механизъм за отмяна:

.NET Framework 4.5 и .NET Core:

int partCount = 0;

var tokenSource = new CancellationTokenSource();

var mbox = new MboxrdStorageReader(fileName, new MboxLoadOptions { LeaveOpen = false });

// Subscribe to events
mbox.MboxFileCreated += (sender, e) =>
{
    partCount++;
    if (partCount >= 5)
        tokenSource.Cancel();
};

System.Threading.Tasks.Task task = mbox.SplitInto(10000000, outputPath, tokenSource.Token);
task.Wait();

.NET Framework по-нисък от 4.5:

int partCount = 0;
var mbox = new MboxrdStorageReader(fileName, new MboxLoadOptions { LeaveOpen = false });
mbox.SplitInto(10000000, outputPath);

mbox.MboxFileCreated += (sender, e) =>
{
    partCount++;
    if (partCount >= 5)
        mbox.Cancel();
};

Net: Конвертиране на имейл файлове с C# API

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

Програмено конвертиране на имейл файлове между формати в C#

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

Поддържани формати

Всички формати, достъпни за конверсия с Aspose.Email за .NET, са изброени на Поддържани файлови формати страница. Можете да намерите описание на възможностите и предимствата им, кодови примери и добри практики на следните страници:

Конвертиране на EML/EMLX в други формати - Този тип конверсия включва преобразуване на файлове EML/EMLX към EMLX, HTML, ICS, MBOX, MHTML, MSG, OFT, OST, PST и VCF формати.
Конвертиране на HTML в други формати
Конвертиране на ICS в други формати
Конвертиране на MBOX в други формати
Конвертиране на MHTML в други формати
Конвертиране на MSG в други формати
Конвертиране на OFT в други формати
Конвертиране на OST в други формати
Конвертиране на PST в други формати
Конвертиране на VCF в други формати

Персонализация

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

Опциите за запазване, предоставени от Aspose.Email, осигуряват съвместимост и интероперативност с широк набор от имейл клиенти, сървъри и платформи.

Партидна обработка

Aspose.Email позволява импорт на набор от съобщения от папка във файл с целеви формат. Например, е възможно да се импортират повече от едно EML съобщение в папка Inbox в PST файл.

Целост на данните

Aspose.Email за .NET осигурява запазване на оригиналното форматиране, прикачени файлове и мултимедийни елементи на имейла по време на процеса на конвертиране. Можете да научите детайли за обработката на елементите при конверсия на страниците с необходимия тип конверсия. Например, на страницата [Convert EML to other formats] можете да разберете за методите за запазване на ресурси при конвертиране на EML към HTML без загуба на данни. За тази цел Aspose.Email предоставя набор от класове и методи за манипулиране на ресурси в HTML файл и кодов пример за тестване.

Безплатна пробна версия

На Aspose.Email за .NET на официалния сайт се предлага безплатна пробна версия на библиотеката за обработка на имейли. С безплатната проба разработчиците могат да изследват широка гама от функции и възможности, включително парсиране, манипулиране, конвертиране и други.

Net: Четене и експортиране на Zimbra TGZ файлове в Node.js чрез .NET

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

Zimbra е облачна имейл и колаборационна платформа, предоставяща имейл, контакти, календари, споделяне на файлове, задачи и съобщения – достъпни чрез Zimbra Web Client на всяко устройство.

Aspose.Email за Node.js чрез .NET позволява на разработчиците да четат, извличат и експортират данни от Zimbra TGZ резервни файлове, използвайки TgzReader клас. Лесно можете да достъпите всички съобщения, да преброите общия брой елементи и да експортирате съобщения, контакти или календарни данни от TGZ файлове в общи формати.

Четене на всички съобщения от Zimbra TGZ файл

Този TgzReader клас позволява да прочетете всички съобщения, съхранени в Zimbra TGZ резервен файл.

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

const asposeemail = require('@aspose/email');
const fs = require('fs');

// Path to the Zimbra TGZ file
const tgzPath = "ZimbraSample.tgz";

// Create a TgzReader instance
const reader = new asposeemail.TgzReader(tgzPath);

// Read and display all messages
while (reader.readNextMessage()) {
    const directoryName = reader.currentDirectory;
    console.log("Directory:", directoryName);

    const message = reader.currentMessage;
    console.log("Subject:", message.subject);
}

reader.dispose();
console.log("All messages read successfully from the Zimbra TGZ file.");

Брой на общите елементи в Zimbra TGZ файл

Бързо можете да определите колко имейл елементи съществуват в TGZ резервно копие, използвайки getTotalItemsCount() метод на TgzReader клас.

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

const asposeemail = require('@aspose/email');

const tgzFile = "ZimbraSample.tgz";
const reader = new asposeemail.TgzReader(tgzFile);

const totalCount = reader.getTotalItemsCount();
console.log(`Total items in TGZ file: ${totalCount}`);

reader.dispose();

Запазване на съобщения и структура на папки от Zimbra TGZ файл

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

Следният кодов пример демонстрира как да извлечете и експортирате всички Zimbra имейл съобщения от TGZ архивен файл, използвайки библиотеката Aspose.Email.

const asposeemail = require('@aspose/email');

const tgzFile = "ZimbraSample.tgz";
const outputDir = "Output/Zimbra/";

const reader = new asposeemail.TgzReader(tgzFile);
reader.exportTo(outputDir);

reader.dispose();
console.log(`All Zimbra messages exported to: ${outputDir}`);

Експорт на календар и контакти от Zimbra резервни файлове

Архивите от Zimbra TGZ могат да включват папки с контакти и календари. Можете да ги експортирате във формати VCard (.vcf) и iCalendar (.ics) използвайки същия exportTo() метод.

const asposeemail = require('@aspose/email');

const tgzFile = "ZimbraBackup.tgz";
const outputPath = "Output/ZimbraData/";

const reader = new asposeemail.TgzReader(tgzFile);

// Contacts can be found in "Contacts" and "Emailed Contacts" folders.
// Calendar entries can be found in the "Calendar" folder.
reader.exportTo(outputPath);

reader.dispose();
console.log("Zimbra calendar and contacts exported successfully.");

Net: Работа с IBM Notes

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

About IBM Notes

IBM Notes е клиент, а IBM Domino е сървър на платформа за съвместен клиент-сървър софтуер. IBM Notes предоставя функции за сътрудничество като имейл, календари, списъци със задачи, управление на контакти и др. Файловият базов данни, използван от IBM Notes, се съхранява във формат Notes Storage Facility (NSF).

Откриване на файл във NSF формат

Следният кодов пример ще ви покаже как да разпознаете NSF файловия формат:

var formatType = FileFormatUtil.DetectFileFormat("storage.nsf").FileFormatType; // Returns FileFormatType.Nsf

Read messages from NSF storage file

Забележка: реализацията на NSF е доста ограничена. По принцип, може да се срещнат някои проблеми в следните случаи:

Файлът е създаден от Notes версия 7 и по-нова
Използва се компресия LZ1

Aspose.Email предоставя NotesStorageFacility клас за четене на NSF файлове. The NotesStorageFacility клас предоставя EnumerateMessages метод, който итерира съобщенията в NSF файл за съхранение. Следният примерен код демонстрира използването на NotesStorageFacility клас и EnumerateMessages метод за четене на съобщения от NSF файл за съхранение.

Моля, обърнете внимание, че е реализирано само четенето на съобщения. Четенето на папки все още не се поддържа поради липса на спецификация.

Net: Програмиране на проверка на имейл

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

Използване на Aspose.Email.Verifications

Aspose.Email.Verifications предоставя пълна поддръжка за валидиране на имейл адреси. С помощта на класа Aspose.Email.Verifications.EmailValidator могат да се извършват различни видове проверки, включително проверка на синтаксиса на имейла, проверка на домейна и проверка на потребителски акаунти с пощенски сървъри. Изброяването ValidationPolicy се използва за задаване нивото на политика за валидиране:

SyntaxOnly проверява само синтаксиса на имейл адреса.
SyntaxAndDomain валидира синтаксиса на имейл адреса, след което домейна.
MailServer валидира адреса, като се опитва да се свърже с пощенския сървър.

Примерно приложение

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

За да създадете приложение, което използва Aspose.Email.Verifications за проверка на имейл адреси:

Отворете Visual Studio.
В менюто File, кликнете New, след това Project. За простота, това ще бъде конзолна програма. Изберете C# или VB.NET проект, както предпочитате.

|Creating a new project| | :- | ||

Добавете референт към конзолното приложение.

|Adding a reference to Aspose.Email| | :- | ||

Придвижете се до Aspose.Email.dll в директорията Bin под директорията на инсталацията на Aspose.Email.

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

Създаване и изпълнение.

|Стартиране на приложението.|| | :- | :- | || |

Basic Validation Functionality

Използвайте Aspose.Email.Verifications за проверка на валидността на имейл адреси. За тази цел Aspose.Email.Verifications разполага с класа EmailValidator.

Validating Emails

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

Валидиране на домейн

Aspose.Email.Verifications може да проверява валидността на име на домейн.

Валидиране на пощенски сървър

Aspose.Email.Verifications може да проверява валидността на пощенски сървър.

Net: Работа с AMP HTML имейли

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

За AMP

AMP (Accelerated Mobile Pages) е отворена рамка, създадена от Google с HTML, CSS и JavaScript. Тя позволява изграждане на леки имейли с по-бързо зареждане. AMP предоставя множество компоненти като карусели, форми, изображения и др. Освен че е бърза, AMP имейлите рендират напълно интерактивни съобщения директно в клиентския имейл, като потребителите могат да взаимодействат с тях, например да попълнят форма или да отговорят на проучване, без да напускат имейл клиента.

Работа с AMP HTML имейли

Aspose.Email предоставя AmpMessage който представлява AMP имейл. Aspose.Email предоставя много класове за добавяне на компоненти към AMP имейли като AmpImage, AmpCarousel, AmpAccordion, AmpForm и др. Пълен списък с класовете можете да намерите на Aspose.Email.Amp страница. Следният фрагмент от код демонстрира създаване, запазване и актуализиране на AMP имейли с помощта на Aspose.Email API.

Net: Технически статии

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

Net: Често задавани въпроси

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

Question

Здравей! за следния код:


 Aspose.Email.Mime.ContentType ct = new Aspose.Email.Mime.ContentType();

ct.MediaType = "application/msword";

ct.CharSet = "ISO-2022-JP";

Attachment att = new Attachment("Test.doc", ct);

Console.WriteLine(att.ContentType.Name);

att.ContentType.Name връща името на прикрепения документ. Това ли е очакваното поведение?

Отговор: Да, това е очаквано поведение. Ако ContentType.Name не е зададен изрично, стойността на името на файла ще бъде използвана като име.

Въпрос:

Защо ExchangeWebServiceClient.FetchMessage превръща вграденият изображения като прикачени файлове?

Отговор: Microsoft Exchange Server има такава функционалност като ‘Конверсия на съдържание, което е процесът на правилно форматиране на съобщение за всеки получател. Решението за извършване на конверсия на съдържанието зависи от дестинацията и формата на обработваното съобщение.

С други думи, за неизвестни клиенти сървърът може да форматира съобщението според настройките на сървъра (за избор на най‑подходящия формат). Както разбирате, най‑универсалният формат за всеки клиент е ’text/plain’ и тези настройки са конфигурируеми на сървъра.

Моля, имайте предвид: Outlook е добре известен имейл клиент за Microsoft Exchange Server (в случай че версията на MS Outlook е по-стара от тази на сървъра). Това означава, че Exchange Server предава формата на съобщението според възможностите на Outlook. В нашия случай, когато ExchangeWebServiceClient се опитва да извлече съобщение, възможностите на нашите компоненти са неизвестни за MS Exchange. Сървърът предава съобщението към компонентите в най‑опростения формат (text/plain). С други думи, няма html части в отговора от сървъра. В тази ситуация изображенията се включват в съобщението като прикачени файлове.

Съществува начин да се избегне описания проблем. Ако съобщението на сървъра има Content-Type: multipart/alternative и една от частите му е text/plain, в този случай съобщението се предава към клиента както е. Изображенията се показват в тялото на съобщението, защото съобщението също съдържа html част. В текущия сценарий съобщението се добавя към MS Exchange с помощта на MS Outlook и като резултат Content-Type на съобщението не е ‘multipart/alternative’. Поради това имаме проблем при опит за извличане на съобщението. Например, ето примери за подобни проблеми: един(http://support.risualblogs.com/blog/2011/02/24/html-mails-sent-via-owa-and-outlook-2011-are-received-as-plain-text-mails-externally/), два(http://forums.mozillazine.org/viewtopic.php?f=39&t=628678), три(http://stackoverflow.com/questions/4681798/how-do-i-send-html-multipart-alternative-from-exchange-web-services-2010-sp1). Като заключение, ситуацията описана в проблема (изображения, включени в съобщението като прикачени файлове) не е бъг на компонентите на aspose. Това е специфична функция на Exchange сървъра.

Question: Как да извлека данни от прикачения файл "oleData.mso", който получих като резултат от четенето на MapiMessage, съдържащ вградения OLE обект?

Answer: Файлове като "oleData.mso" се отнасят до формат Microsoft Compound Document (MCDF) и, за съжаление, поддръжката на такива файлове е извън обхвата на Aspose.Email. Има обаче някои отворени .NET библиотеки, например OpenMCDF, които могат да се използват за четене на съдържанието на такива файлове с цел записване на диск.

Question: Можем ли да пишем в същия PST файл в паралелни нишки, използвайки същите обекти?

Answer: Не, безопасността при работа с нишки не е гарантирана в такъв случай. Записването на съобщения трябва да се извършва в един единствен поток. Въпреки това, продуктът трябва да работи правилно с различни обекти от различни потоци.