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 клас. Вкажіть його властивості.
Використайте Надіслати метод об’єкта клієнта для надсилання електронної пошти. Результат операції надсилання зберігається у змінній 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

The 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 до файлу ICS.

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 Client

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

Net: Робота з Exchange WebDav Client

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

Net: Програмування з Gmail

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. The 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 за ідентифікаторами

The MboxStorageReader клас включає EnumerateMessageInfo() метод, який дозволяє перебирати кожне повідомлення у MBOX файлі. Використовуючи цей метод, можна витягнути окремі повідомлення без необхідності багаторазово проходити весь файл. Це підвищує продуктивність і зменшує час обробки.

The MboxMessageInfo class надає EntryId властивість, яка забезпечує доступ до унікальних ідентифікаторів кожного повідомлення у MBOX файлі. Цей ідентифікатор можна зберігати в базі даних або використовувати як посилання для швидкого пошуку та витягування потрібних повідомлень.

The 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 файлi

The 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 файлів

The 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: Як читати та конвертувати MBOX файли Thunderbird у .NET

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

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 на будь‑якому пристрої.

Aspose.Email for Node.js via .NET дозволяє розробникам читати, витягувати та експортувати дані з резервних копій Zimbra TGZ, використовуючи TgzReader клас. Ви можете легко отримати доступ до всіх повідомлень, підрахувати загальну кількість елементів та експортувати повідомлення, контакти або дані календаря з TGZ файлів у поширені формати.

Читати всі повідомлення з файлу Zimbra TGZ

The 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

The 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

Про 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

Читання повідомлень з файлу сховища NSF

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

Файл був створений у Notes версії 7 і вище
Використовується стиснення LZ1

Aspose.Email надає NotesStorageFacility class для читання файлів сховища NSF. NotesStorageFacility class надає EnumerateMessages method, який ітерує повідомлення у файлі сховища NSF. Нижче наведений зразок коду демонструє використання NotesStorageFacility class та EnumerateMessages method для читання повідомлень з файлу сховища 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 за вашим бажанням.

|Створення нового проєкту| | :- | ||

Додайте посилання до консольного застосунку.

|Додавання посилання на Aspose.Email| | :- | ||

Перейдіть до Aspose.Email.dll у каталогу Bin у директорії встановлення Aspose.Email.

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

Зібрати та запустити.

|Запуск застосунку.|| | :- | :- | || |

Базова функціональність валідації

Використовуйте Aspose.Email.Verifications для перевірки дійсності електронних адрес. Для цього у Aspose.Email.Verifications є клас EmailValidator.

Перевірка електронних адрес

Функціональність валідації 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: FAQ

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: Ні, безпечність потоків у цьому випадку не гарантована. Запис повідомлень має виконуватись в одному потоці. Однак продукт має коректно працювати з різними об’єктами з різних потоків.

Documentation – Посібник розробника

Net: Надсилати електронні повідомлення через MailGun та SendGrid

Надсилати повідомлення асинхронно

Встановити користувацький базовий URL для SendGrid

Net: Робота з MIME повідомленнями

Net: Керування зустрічами: створення та маніпуляції, конвертація ICS у MSG

Створити зустріч та зберегти її на диск у форматі MSG або ICS

Створити зустріч з HTML‑вмістом

Створити запит чернетки зустрічі

Створення чернетки зустрічі з тексту

Налаштування зустрічей

Встановити статус учасників зустрічі

Налаштування ідентифікатора продукту для iCalendar

Завантаження зустрічей

Завантажити зустріч у форматі ICS

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

Читання кількох подій з файлу ICS

Запис кількох подій у файл ICS

Визначення версії зустрічі

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

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

Net: Робота з SMTP клієнтом

Net: Робота з POP3 клієнтом

Net: Робота з клієнтом IMAP

Net: Робота з клієнтом Exchange EWS

Net: Робота з Microsoft Graph Client

Net: Робота з Exchange WebDav Client

Net: Програмування з Gmail

Net: Програмування з Thunderbird

Читання MBOX файлів

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

Витяг повідомлень з MBOX за ідентифікаторами

Налаштування параметрів завантаження при читанні повідомлень з MBOX

Встановлення бажаного кодування тексту під час завантаження MBOX‑файлів для читання

Отримання загальної кількості повідомлень у MBOX файлi

Отримати поточний розмір повідомлення

Конвертація MBOX у PST із збереженням або видаленням підпису

Запис MBOX файлів

Розділити сховище MBOX/Скасувати операцію розділення

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

Net: Конвертування файлів електронної пошти за допомогою C# API

Програмно конвертувати файли електронної пошти між форматами на C#

Підтримувані формати

Налаштування

Пакетна обробка

Цілісність даних

Безкоштовна пробна версія

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

Читати всі повідомлення з файлу Zimbra TGZ

Підрахувати загальну кількість елементів у файлі Zimbra TGZ

Зберегти повідомлення та структуру папок з файлу Zimbra TGZ

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

Net: Робота з IBM Notes

Про IBM Notes

Виявлення файлу у форматі NSF

Читання повідомлень з файлу сховища NSF

Net: Програмування перевірки електронної пошти

Використання Aspose.Email.Verifications

Зразок застосунку

Базова функціональність валідації

Перевірка електронних адрес

Перевірка домену

Перевірка поштового сервера

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

Про AMP

Робота з AMP HTML листами

Net: Технічні статті

Net: FAQ

Завантажити зустріч у форматі ICS

Читання кількох подій з файлу ICS