Documentation – Початок роботи

Net: Огляд продукту

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

Ласкаво просимо до Aspose.Email для .NET

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

Aspose.Email реалізує кілька мережевих протоколів, наприклад, SMTP, MIME, POP3, IMAP; формати файлів повідомлень, наприклад, EML, MSG, MHT; формати зберігання пошти, такі як PST і MBOX; та Exchange Servers, що дозволяє розробникам створювати широкий спектр застосувань для обробки електронної пошти. Aspose.Email допомагає розробникам програмувати, не заглиблюючись у складності деталей формату повідомлень.

Опис продукту

Aspose.Email for .NET реалізований за допомогою Managed C# і може використовуватися з будь‑якою мовою .NET, такою як C#, VB.NET та J#, тощо. Бібліотеку можна інтегрувати в будь‑який тип застосунку, від веб‑застосунків ASP.NET до Windows‑застосунків. Aspose.Email також надає повноцінні приклади, написані на C#, щоб розробники могли швидко почати роботу. Її можна використовувати для виконання різноманітних завдань у застосунках:

Читання та парсинг листів з різних форматів, таких як EML, MSG, PST, OST та MBOX.
Створення та надсилання листів. Програмно створюйте та надсилайте електронні листи.
Витягування вкладень з листів та їх окреме збереження.
Обробка елементів Outlook, таких як події календаря, контакти, розсилкові списки, завдання, нотатки тощо.
Маніпуляція властивостями листа такими як відправник, одержувач, тема, тіло та вкладення.
Конвертація листів між різними форматами електронної пошти, такими як EML, EMLX, HTML, ICS, MBOX, MHT, MSG, OFT, OST, PST та VCF.
Робота з папками листів у файлах PST, OST і MBOX, виконуючи операції, такі як додавання, видалення та переміщення листів.
Обробка підписів та шифрування листів. Використовуйте різні функції безпеки, такі як цифрові (SMIME) підписи, шифрування та дешифрування, щоб забезпечити безпечну обробку листів.
Взаємодія з поштовими серверами за допомогою протоколів, таких як POP3, IMAP, SMTP, Exchange Web Services (EWS) та MS Graph.
Надсилання листів через SendGrid та MailGun. Інтегруйтеся з сервісами доставки SendGrid і MailGun, оптимізуйте процеси доставки листів безпосередньо у ваших .NET‑застосунках.
Витяг та генерування даних календаря: Витягайте та створюйте календарні дані, такі як запрошення та зустрічі у форматі ICS, що забезпечує інтеграцію з календарними застосунками.
Пошук і фільтрація листів за критеріями, такими як відправник, одержувач, тема, дата тощо.
Обробка заголовків листа , наприклад, додати власні заголовки або змінити існуючі.
Керування контактами. Легко працюйте з файлами контактної інформації у форматі VCF, включаючи читання, запис і модифікацію контактів.
Робота в асинхронному режимі. Ефективно обробляйте операції з листами, не блокуючи основний потік.
Mail Merge. Створюйте персоналізовані листи за допомогою злиття листів з різних джерел даних, таких як DataTable, DataReader тощо.
Надсилання масових листів. Надсилайте персоналізовані повідомлення багатьом одержувачам одночасно, ефективно керуючи масштабними email‑кампаніями.

Що робить Aspose.Email for .NET видатним?

Існує кілька вагомих причин використовувати Aspose.Email for .NET у ваших застосунках:

Aspose.Email пропонує широкий спектр функцій для обробки різних аспектів електронної пошти, включаючи читання, запис, аналіз, конвертацію та маніпулювання листами в різних форматах.
Aspose.Email for .NET розроблений для безперешкодної роботи на різних платформах, включаючи Windows, Linux та macOS.
Підтримка різноманітних форматів файлів електронної пошти, таких як EML, MSG, PST, OST, MBOX, EMLX тощо. Така широка підтримка дозволяє працювати з листами з різних джерел і систем, підвищуючи універсальність ваших застосувань.
Aspose.Email інтегрується з популярними середовищами розробки, такими як Visual Studio.
Aspose.Email підтримується командою розробників, які постійно удосконалюють і оптимізують бібліотеку. Вона отримує регулярні оновлення та поліпшення, які включають нові функції та виправлення помилок. Додатково Aspose надає всебічну технічну підтримку, щоб допомогти вам у будь‑яких питаннях чи проблемах, що можуть виникнути під час використання бібліотеки.

Технічна підтримка

Aspose надає необмежену безкоштовну технічну підтримку для всіх своїх продуктів. Підтримка доступна всім користувачам, включаючи тих, хто користується пробною версією.

Якщо вам потрібна допомога, відвідайте Aspose.Forums. Розмістіть своє питання на форумі Aspose.Email for .NET, і воно буде відповідане протягом кількох годин.

Повідомлення про проблему

Якщо у вас є проблема, дотримуйтесь цих простих кроків, щоб забезпечити ефективне вирішення:

Переконайтеся, що ви використовуєте останню версію продукту перед повідомленням про проблему. Дивіться Сторінка завантаження Aspose.Email for .NET щоб дізнатися про останню версію.
Ознайомтеся з форуми, ця Wiki документація та Посилання на API перед подачею проблеми. На ваше питання вже може бути відповідь.
При повідомленні про проблему, будь ласка, включіть оригінальний документ і, можливо, фрагмент вашого коду, який викликає проблему. Якщо потрібно прикріпити декілька файлів, заархівуйте їх в один. Безпечно прикріплювати документи у форумах, оскільки доступ до файлів мають лише ви та розробники Aspose.
Будь ласка, намагайтеся повідомляти про одну проблему в одному темі. Якщо у вас є інша проблема, повідомте про неї в окремій темі.

Aspose не надає технічну підтримку по телефону. Телефонна підтримка доступна лише для питань щодо продажу та покупки.

Net: Підтримувані протоколи та сервіси

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

Aspose.Email для .NET пропонує розширену підтримку різних протоколів та сервісів електронної пошти, дозволяючи розробникам безперешкодно інтегрувати передові можливості обробки пошти у свої .NET‑застосунки. Вони полегшують зв’язок з поштовими серверами, отримання листів, надсилання пошти та управління текою поштових скриньок. Нижче наведено всебічний огляд протоколів і сервісів, що підтримуються Aspose.Email для .NET:

Protocol	Description
POP3 (Post Office Protocol version 3)	POP3 — це широко використовуваний протокол для отримання електронних листів з поштового сервера. Aspose.Email для .NET дозволяє розробникам взаємодіяти з POP3‑серверами для завантаження листів, читання заголовків повідомлень та отримання їх вмісту. За допомогою Aspose.Email розробники можуть легко реалізувати функції, такі як завантаження листів з POP3‑серверів, позначення листів як прочитаних та видалення листів із сервера.

Protocol

Description

POP3 (Post Office Protocol version 3)

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

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

Net: Підтримувані формати файлів

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

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

|Формат|Опис|Завантаження|Збереження| | :- | :- | :- | :- | |MSG|Цей формат використовується Microsoft Outlook та Exchange для зберігання електронних листів, контактів, зустрічей або інших завдань. Aspose.Email підтримує читання, запис і зміну MSG‑файлів.| | | |PST|Він представляє файли особистого сховища Outlook (PST), які зберігають листи, елементи календаря, нотатки, контакти та декілька інших форматів файлів. Використовується для архівації даних електронної пошти офлайн. Aspose.Email дозволяє працювати з PST‑файлами, включаючи читання, запис і маніпулювання даними.| | | |OST|Він представляє дані поштової скриньки користувача в офлайн-режимі на локальному комп’ютері після реєстрації на Exchange Server за допомогою Microsoft Outlook. Aspose.Email дозволяє працювати з OST‑файлами, включаючи читання та маніпулювання даними.| | | |OFT|Файли шаблонів листів, створені за допомогою Microsoft Outlook. Aspose.Email дозволяє працювати з OFT‑файлами, включаючи читання та запис.| | | |OLM|Цей формат використовується Microsoft Outlook для Mac для зберігання електронних листів, контактів, журналів, даних календаря та інших даних користувачів. Aspose.Email підтримує вилучення, маніпулювання та конвертацію даних, що містяться в цих архівах.| | | |EML|Він представляє електронні листи, збережені за допомогою Outlook та інших відповідних застосунків. Aspose.Email надає підтримку читання та запису EML‑файлів, а також їх конвертації в інші формати.| | | |EMLX|Це формат, який використовується Apple Mail для зберігання одного електронного листа. Aspose.Email дозволяє читати та записувати EMLX‑файли.| | | |MBOX|Він представляє контейнер для колекції електронних листів. Aspose.Email підтримує читання та запис MBOX‑файлів.| | | |ICS|Формат iCalendar використовується для обміну та розгортання календарних подій та планування. Aspose.Email підтримує читання та запис ICS‑файлів, що дозволяє інтегрувати календарні дані у застосунки.| | | |VCF|Віртуальний формат картки (VCard) — це цифровий файл для збереження контактної інформації. Aspose.Email дозволяє користувачам читати, записувати та маніпулювати контактними даними.| | | |HTML|HTML (HyperText Markup Language) — це розширення для веб-сторінок, створених для відображення в браузерах. Aspose.Email надає розробникам можливість працювати з HTML‑файлами, полегшуючи вилучення та використання їхнього вмісту у застосунках.| | | |MHTML|Формат архіву веб‑сторінок, який зберігає HTML‑кód та пов’язані ресурси в одному файлі. Aspose.Email підтримує читання MHTML‑файлів, що дозволяє вилучати їхній вміст для використання в застосунках.| | |

Net: Як запустити Aspose.Email

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

Нижче ми надаємо покроковий посібник з налаштування та запуску Aspose.Email на Linux і Windows, починаючи з простого прикладу "Hello World".

Щоб почати використовувати бібліотеку, просто виконайте кроки.

Hello World

Створити новий проєкт Відкрийте Visual Studio і створіть новий проєкт Console Application.
Встановити Aspose.Email Використайте NuGet Package Manager для встановлення Aspose.Email. Відкрийте Package Manager Console і виконайте:
```
Install-Package Aspose.Email
```

Написати код

Додайте наступний код у файл Program.cs:


using System;
using Aspose.Email;

class Program
{
    static void Main(string[] args)
    {
        // Create a new email message
         var eml = new MailMessage
         {
             Subject = "Hello World!",
             Body = "This is the body of the email.",
             // Specify sender and recipient
             From = "sender@example.com",
             To = "recipient@example.com"
         };

         // Display the message
         Console.WriteLine("Subject: " + eml.Subject);
         Console.WriteLine("Body: " + eml.Body);

         // Save email in EML format
         eml.Save("my.eml", SaveOptions.DefaultEml);

         // Save email in MSG format
         eml.Save("my.msg", SaveOptions.DefaultMsgUnicode);
    }
}

Запустити застосунок

Виконайте застосунок. Ви повинні побачити тему та тіло листа, виведені у консоль.

Запустити Aspose.Email для .NET на Linux

Запуск Aspose.Email для .NET на Linux передбачає налаштування .NET‑середовища на вашій Linux‑машині. Дотримуйтеся цих кроків:

Встановити .NET SDK

Завантажте та встановіть .NET SDK з офіційного веб‑сайту Microsoft .NET.

Наприклад, на Ubuntu можна встановити .NET SDK за допомогою наступних команд:

wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install -y apt-transport-https
sudo apt-get update
sudo apt-get install -y dotnet-sdk-6.0

Створити новий проєкт

Відкрийте термінал і створіть новий .NET Console Application:
```
dotnet new console -n HelloWorldAspose
cd HelloWorldAspose
```
Додати пакет Aspose.Email

Додайте Aspose.Email до вашого проєкту:
```
dotnet add package Aspose.Email
```
Написати код Замініть вміст Program.cs прикладом коду "Hello World", наведеним вище.
Запустити застосунок: Виконайте застосунок:
```
dotnet run
```

Net: Огляд функцій

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

У Aspose.Email для .NET різноманітні класи та методи категоризовані за просторами імен, кожен з яких виконує певні завдання, пов’язані з обробкою електронної пошти. Від роботи з протоколами SMTP, POP3 та IMAP до управління календарними інтеграціями та плануванням завдань — кожен простір імен створений для конкретних сценаріїв використання. Такий структурований підхід не лише спрощує кодування, а й забезпечує розробникам легку реалізацію поштових рішень.

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

Aspose.Email

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

Центральним компонентом цього простору імен є MailMessage клас, універсальна та потужна сутність, яка полегшує створення, маніпулювання та обробку електронних листів. Клас MailMessage підтримує широкий спектр функцій, включаючи складання листів з форматуванням багатого тексту, вбудовування зображень, приєднання файлів та вказування кількох отримувачів з різними ролями (to, cc, bcc). Він також забезпечує потужні можливості парсингу та читання вхідних листів, дозволяючи розробникам без проблем витягати такі дані, як тема, відправник, отримувачі та вміст тіла. Крім того, MailMessage плавно інтегрується з різними поштовими протоколами, такими як SMTP, IMAP та POP3, забезпечуючи просте та надійне надсилання та отримання листів.

Aspose.Email.Amp

Надає класи для обробки повідомлень з тілом AMP HTML

Aspose.Email.Amp пропонує потужний набір класів, присвячених обробці повідомлень, що містять тіла AMP HTML, що робить його інструментом для розробників, які бажають впроваджувати динамічний та інтерактивний вміст електронної пошти. У центрі цієї можливості знаходиться AmpMessage клас, який слугує основним компонентом для створення, маніпулювання та рендерингу електронних листів, збагачених AMP. Цей клас дозволяє розробникам безшовно інтегрувати багаті медіа та інтерактивні елементи безпосередньо в тіло листа, використовуючи швидкість та привабливі можливості AMP HTML.

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

Aspose.Email.AntiSpam

Надає класи для впровадження самонавчальних фільтрів для виявлення спам-листів

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

Aspose.Email.Bounce

Надає класи для обробки повідомлень про відскок

Aspose.Email.Bounce пропонує комплексне рішення для поштових застосунків щодо ефективного управління повідомленнями про відскок. Клас [BounceResult] (https://reference.aspose.com/email/net/aspose.email.bounce/bounceresult/#bounceresult-class) представляє результат аналізу повідомлення як повідомлення про відскок.

Aspose.Email.Calendar

Містить класи для роботи з календарями

Aspose.Email.Calendar є простором імен, розробленим для надання розробникам інструментів управління та маніпулювання календарними даними. The Appointment клас інкапсулює функціональність для обробки календарних подій та зустрічей. За допомогою класу Appointment розробники можуть без зусиль створювати, змінювати та керувати календарними подіями, включаючи встановлення часу початку та закінчення, повторюваних шаблонів, нагадувань та запрошення учасників. Клас підтримує формат iCalendar (ICS), забезпечуючи сумісність та інтеграцію з різними календарними системами. Крім того, клас Appointment дозволяє експортувати календарні файли у формат MSG, сприяючи плавному обміну даними та синхронізації між різними платформами.

Aspose.Email.Clients.DeliveryService.Mailgun

Реалізує клієнт для сервісу доставки електронної пошти Mailgun

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

Aspose.Email.Clients.DeliveryService.SendGrid

Реалізує клієнт для сервісу доставки електронної пошти SendGrid

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

Aspose.Email.Clients.Exchange.Dav

Надає класи для доступу до Exchange Server за допомогою протоколу WebDav Exchange Store

Aspose.Email.Clients.Exchange.Dav простір імен має інструменти для взаємодії з Exchange Server через протокол WebDav Exchange Store. Клас ExchangeClient клас слугує для доступу до ресурсів Exchange Server.

Aspose.Email.Clients.Exchange.WebService

Надає доступ до MS Exchange Server за допомогою Exchange Web Services (EWS)

Aspose.Email.Clients.Exchange.WebService призначений для надання доступу до Microsoft Exchange Server за допомогою Exchange Web Services (EWS). Його основний клас, EWSClient, полегшує взаємодію з Exchange Server. EWSClient дозволяє розробникам ефективно підключатися до сервера та виконувати різні операції, включаючи управління листами, календарями, контактами, завданнями та публічними папками. Цей клас підтримує функції, такі як надсилання та отримання листів, організація папок поштової скриньки, планування зустрічей та обробка запитів на зустріч.

Aspose.Email.Clients.Google

Надає класи для доступу до облікових записів Google

Aspose.Email.Clients.Google простір імен, який надає класи для легкого доступу та управління обліковими записами Google. Основний компонент у цьому просторі імен є GmailClient. Цей клас дозволяє розробникам інтегрувати та взаємодіяти зі службою Google Mail, використовуючи автентифікацію OAuth 2.0.

Aspose.Email.Clients.Graph

Надає класи для доступу до служб Microsoft 365 за допомогою REST API

The Aspose.Email.Clients.Graph призначений для доступу та управління службами Microsoft 365 через REST API, пропонуючи підхід до інтеграції функціональності електронної пошти у .NET‑застосунки. У центрі цього простору імен знаходиться GraphClient клас, який дає розробникам можливість безперешкодно взаємодіяти зі службами Microsoft 365. GraphClient забезпечує широкий спектр операцій, включаючи надсилання та отримання листів, управління подіями календаря та обробку контактів. Підтримуючи автентифікацію OAuth 2.0, він гарантує безпечний доступ до даних користувачів, дотримуючись сучасних стандартів безпеки. Крім того, GraphClient спрощує маніпуляції з папками, синхронізацію поштових скриньок та отримання метаданих листів.

Aspose.Email.Clients.Imap

Надає класи для доступу та маніпулювання повідомленнями за допомогою IMAP

The Aspose.Email.Clients.Imap простір імен створений для взаємодії з поштовими серверами за допомогою Internet Message Access Protocol (IMAP). Основним у цьому просторі імен є ImapClient клас, який служить основним інтерфейсом для виконання широкого спектру операцій з електронною поштою. Після підключення розробники можуть використовувати ImapClient для перелічення, отримання, видалення та пошуку листів у різних поштових папках. Крім того, він пропонує можливості управління та маніпулювання цими папками, включаючи створення, перейменування та видалення.

Aspose.Email.Clients.Pop3

Надає класи для доступу та маніпулювання повідомленнями за допомогою POP3

The Aspose.Email.Clients.Pop3 простір імен розроблений для спрощення взаємодії з поштовими серверами, які використовують протокол Post Office Protocol версії 3 (POP3), пропонуючи набір класів для доступу та маніпулювання електронними листами. У серці цього простору імен знаходиться Pop3Client клас. Клас Pop3Client полегшує встановлення захищених з’єднань з POP3‑сервером, підтримуючи різноманітні механізми автентифікації для безпечного та надійного доступу. Після підключення Pop3Client дозволяє розробникам виконувати основні операції з листами, такі як отримання повідомлень з сервера, перелік листів, позначення певних повідомлень для видалення та отримання повних деталей повідомлення, включаючи заголовки та вкладення. Крім того, він забезпечує вбудовану підтримку протоколів SSL та TLS.

Aspose.Email.Clients.Smtp

Надає класи для надсилання повідомлень за допомогою SMTP

The Aspose.Email.Clients.Smtp простір імен створений для розробників, які хочуть інтегрувати функціональність SMTP (Simple Mail Transfer Protocol) у свої .NET‑застосунки для надсилання листів. У центрі цього простору імен знаходиться SmtpClient клас. Клас SmtpClient пропонує набір можливостей, дозволяючи розробникам встановлювати захищені з’єднання з SMTP‑сервером та надсилати листи. Він підтримує різні методи автентифікації, забезпечуючи сумісність з широким спектром SMTP‑серверів, і надає параметри для вказування пріоритету повідомлення, сповіщень про доставку та власних заголовків. Завдяки вбудованій підтримці протоколів шифрування SSL та TLS, клас SmtpClient забезпечує безпечне спілкування.

Aspose.Email.DKIM

Містить класи для роботи з підписами DKIM

The Aspose.Email.DKIM простір імен пропонує класи для обробки підписів DomainKeys Identified Mail (DKIM), щоб забезпечити цілісність та автентичність електронної пошти. Клас DKIMSignatureInfo клас слугує основним компонентом для забезпечення інформації, пов’язаної з DKIM.

Aspose.Email.Mapi

Містить класи, які представляють повідомлення Outlook, контакти, зустрічі та працюють з форматом файлів Microsoft Outlook PST/OST

The Aspose.Email.Mapi простір імен створений для роботи з даними Microsoft Outlook. Основний клас у цьому просторі імен є MapiMessage, який служить для обробки повідомлень Outlook. MapiMessage забезпечує можливості створення, читання, модифікації та збереження повідомлень Outlook у форматі MSG. Розробники можуть використовувати цей клас для доступу та маніпулювання вмістом елементів Outlook, включаючи тему, тіло, вкладення, одержувачів та властивості.

Окрім управління окремими листами, простір імен Aspose.Email.Mapi також включає:

класи для обробки контактів (MapiContact),
заплановані події (MapiCalendar),
та інших елементів Outlook, що робить можливим програмне взаємодію з різними об’єктами, які зазвичай зберігаються у файлах PST (Personal Storage Table) та OST (Offline Storage Table). Цей набір класів забезпечує інтеграцію з форматами сховища даних Outlook, полегшуючи такі завдання, як міграція листів, резервне копіювання та синхронізація.

Aspose.Email.PersonalInfo.VCard

Містить класи для роботи з форматом файлів VCard

The Aspose.Email.PersonalInfo.VCard простір імен є важливим для розробників, які хочуть маніпулювати форматами файлів VCard у своїх застосунках. Основний клас у цьому просторі імен є VCardContact. Цей клас має ключове значення для створення, аналізу та управління файлами VCard, які широко використовуються для обміну контактною інформацією. За допомогою VCardContact розробники можуть читати файли VCard для витягнення деталей контактів або генерувати файли VCard з існуючих даних. Клас підтримує різні версії VCard для сумісності та гнучкості у роботі з різними форматами VCard. Крім того, він включає можливості кодування та декодування контактної інформації, що дозволяє інтеграцію з іншими системами та платформами, які використовують стандарти VCard.

Aspose.Email.Printing

Містить класи, які представляють функціональність друку повідомлень

The Aspose.Email.Printing простір імен створений для надання інструментів, необхідних для друку листів безпосередньо з застосунків. Принтер для листів представлений MailPrinter клас. Цей клас пропонує набір функціональностей для полегшення друку різних форматів повідомлень, включаючи MSG, EML та MHTML. MailPrinter дозволяє налаштувати макет друку, адаптувати параметри сторінки, щоб забезпечити відповідність відображених листів конкретним вимогам.

Aspose.Email.Storage.Mbox

Надає класи для роботи з форматом MBOX

The Aspose.Email.Storage.Mbox простір імен пропонує набір класів, розроблених для управління та маніпулювання форматами файлів MBOX, які широко використовуються для зберігання колекцій електронних листів. Основними класами цього простору імен є MboxStorageReader клас і MboxStorageWriter, які служать основними компонентами для взаємодії з файлами MBOX. Клас MboxrdStorageReader забезпечує можливості читання та обходу файлів MBOX. Він дозволяє розробникам витягувати окремі електронні листи, надаючи можливість програмно обробляти або аналізувати їхній вміст. Крім того, цей клас підтримує безшовну конвертацію витягнутих повідомлень у інші популярні формати, такі як EML або MSG, розширюючи його корисність у різноманітних сценаріях застосування. Клас MboxrdStorageWriter призначений для створення та запису файлів MBOX.

Aspose.Email.Storage.Olm

Надає класи для роботи з форматом файлів Microsoft Outlook OLM

The Aspose.Email.Storage.Olm простір імен — це набір класів, розроблених для управління та маніпулювання файлами Microsoft Outlook OLM, які переважно використовуються для зберігання даних електронної пошти на MacOS. Тут OlmStorage клас є основним компонентом, відповідальним за взаємодію з файлами OLM. Клас OlmStorage дає розробникам можливість завантажувати OLM‑файли, а потім витягувати, читати та маніпулювати їхнім вмістом, включаючи листи, контакти, календарні елементи та нотатки. Зокрема, він дозволяє переглядати ієрархії папок, фільтрувати певні типи повідомлень та ефективно витягувати дані.

Aspose.Email.Storage.Pst

Надає класи для роботи з форматом файлів Microsoft Outlook PST/OST

The Aspose.Email.Storage.Pst простір імен пропонує класи, розроблені для обробки форматів файлів Microsoft Outlook PST та OST, які є важливими для управління даними електронної пошти у Windows. Основний у цьому просторі імен є PersonalStorage клас, основний компонент, відповідальний за взаємодію з файлами PST та OST. Клас PersonalStorage надає можливості завантаження, створення та маніпулювання цими типами файлів. Він дозволяє розробникам виконувати широкий спектр операцій, включаючи витягування та управління листами, контактами, записами календаря, завданнями та нотатками. Клас також підтримує ієрархічну навігацію по папках, забезпечуючи ефективну організацію та отримання даних. Крім того, PersonalStorage спрощує конвертацію вмісту PST і OST у різні інші формати, такі як EML, MSG або MBOX, розширюючи свою корисність.

Aspose.Email.Storage.Zimbra

Надає класи для роботи зі сховищем Zimbra

Aspose.Email.Storage.Zimbra є простором імен у бібліотеці Aspose.Email з TgzReader клас, який служить для доступу та управління архівами Zimbra TGZ (Tar GZip). Клас TgzReader пропонує можливості роботи з архівами електронної пошти, включаючи можливість парсингу та витягування листів, контактів і календарних елементів з TGZ‑файлів, зокрема читання TGZ‑архівів, перебір їх вмісту та програмний доступ до окремих елементів для настроюваної обробки.

Aspose.Email.Tools.Logging

Надає класи для функціональності журналювання

The Aspose.Email.Tools.Logging є простором імен для включення функціональності журналювання у застосунки на базі електронної пошти. Основний клас-компонент у цьому просторі імен є LoggerManager клас, який розроблений для забезпечення можливостей журналювання, дозволяючи застосункам відстежувати та реєструвати різні операційні події.

Aspose.Email.Tools.Merging

Містить класи для створення електронних листів за допомогою шаблонів

The Aspose.Email.Tools.Merging це простір імен для автоматизації створення індивідуальних електронних листів за допомогою шаблонів. У центрі цього простору імен знаходиться TemplateEngine клас, який є основним класом, відповідальним за створення електронних листів за допомогою шаблонів. Клас TemplateEngine дозволяє зливати дані у заздалегідь визначені шаблони, здійснюючи підстановку замісників реальною інформацією. Це особливо корисно для масового генерування персоналізованих листів, забезпечуючи, що кожен одержувач отримує унікальне повідомлення, адаптоване до його контексту.

Aspose.Email.Tools.Search

Містить базові класи для пошуку повідомлень за критеріями

The Aspose.Email.Tools.Search простір імен створено для спрощення процесу пошуку електронних листів за широким спектром критеріїв. Основою цього простору імен є MailQuery клас, який слугує основним компонентом, відповідальним за визначення параметрів пошуку та виконання запитів до сховищ електронних листів. За допомогою MailQuery можна вказати різні умови пошуку, такі як відправник, отримувач, ключові слова теми, діапазони дат та навіть специфічні терміни вмісту. Ця можливість дозволяє фільтрувати та отримувати релевантні листи з великих архівів або поточних поштових скриньок. MailQuery підтримує створення складних запитів за допомогою логічних операторів.

Aspose.Email.Tools.Verifications

Надає класи для функціональності перевірки повідомлень

The Aspose.Email.Tools.Verifications простір імен пропонує класи, необхідні для забезпечення цілісності та достовірності електронних листів. У центрі цього простору імен знаходиться EmailValidator клас, який служить основним компонентом для здійснення різних перевірок валідації електронних листів.

Aspose.Email.Windows.Forms

Містить класи для обробки файлів, перетягнутих з Outlook, у застосунках Windows Forms

Aspose.Email.Windows.Forms це спеціалізований простір імен, розроблений для полегшення інтеграції функціональності, пов’язаної з електронною поштою, у застосунках Windows Forms, особливо зосереджений на обробці файлів, перетягнутих з Microsoft Outlook. Основний клас‑компонент у цьому просторі імен, FileDropTargetManager, надає розробникам можливості керувати та обробляти операції перетягування, що включають елементи Outlook. FileDropTargetManager дозволяє застосункам захоплювати, обробляти та процесувати електронні листи, вкладення та інші елементи Outlook, коли їх перетягують у застосунок Windows Forms. За допомогою цього класу можна реалізовувати функції, такі як витягування та відображення вмісту перетягнутих елементів, збереження вкладень у визначені місця або запуск користувацьких дій залежно від типу перетягнутого елемента.

Aspose.Email.Windows.WPF

Містить класи для обробки файлів, перетягнутих з Outlook, у застосунках Windows Presentation Foundation (WPF)

The Aspose.Email.Windows.WPF простір імен розроблений для інтеграції функціональності, пов’язаної з електронною поштою, у WPF‑застосунках, особливо зосереджений на обробці файлів, перетягнутих з Microsoft Outlook. Основою цього простору імен є FileDropPanel клас, який дозволяє розробникам реалізувати операції перетягування. FileDropPanel діє як спеціалізована панель, що захоплює елементи, перетягнуті з Outlook, включаючи листи, вкладення та інші пов’язані елементи. Він автоматично виявляє, коли елементи опущено на панель, і надає події та методи для їх обробки. Використовуючи FileDropPanel, розробники можуть витягувати вміст листа, зберігати вкладення у зазначені місця або виконувати користувацьку бізнес‑логіку залежно від типу отриманого елемента.

Net: Чому не автоматизація

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

Чому компоненти Aspose є значно кращим варіантом порівняно з автоматизацією Microsoft Office. Ми найчастіше чуємо два запитання тут, у Aspose:

Чи потребують ваші продукти встановлення Microsoft Office для їх роботи? Просте відповідь — ні. Компоненти Aspose повністю незалежні і не пов’язані, не уповноважені, не спонсоровані та не затверджені корпорацією Microsoft.
Чому варто використовувати продукти Aspose замість автоматизації Microsoft Office? Найкоротша відповідь — це те, що існує безліч причин, головна з яких — те, що сам Microsoft настійно рекомендує не використовувати автоматизацію Office у програмних рішеннях: Міркування щодо серверної автоматизації Office. Є декілька причин, чому компоненти Aspose є кращою альтернативою автоматизації. Деякі ключові моменти описані нижче. Також обов’язково перегляньте посилання в кінці цього розділу.

Безпека

Нижче наведено прямий цитат з вищевказаної статті Microsoft:

"Застосунки Office ніколи не передбачали використання на сервері, і тому не враховують проблеми безпеки, з якими стикаються розподілені компоненти. Office не аутентифікує вхідні запити і не захищає вас від випадкового запуску макросів або запуску іншого сервера, який може виконувати макроси, з вашого серверного коду. Не відкривайте файли, завантажені на сервер з анонімного веб‑ресурсу! В залежності від останніх налаштувань безпеки, сервер може запускати макроси під контекстом Administrator або System з повними привілеями, що може скомпрометувати вашу мережу! Крім того, Office використовує багато клієнтських компонентів (наприклад, Simple MAPI, WinInet та MSDAIPP), які можуть кешувати інформацію про автентифікацію клієнта для прискорення обробки. Якщо Office автоматизується на сервері, один екземпляр може обслуговувати більше одного клієнта, і оскільки інформація про автентифікацію кешується для цієї сесії, можливо, що один клієнт може використати кешовані облікові дані іншого клієнта і отримати недозволений доступ, вдаючи себе за інших користувачів."

Продукти Aspose дуже безпечні. Компоненти Aspose працюють у тому ж користувацькому контексті, що й усі ASP.NET‑застосунки, під користувачем ASPNET. Тому компоненти Aspose не становлять потенційну загрозу важливим системним ресурсам. Крім того, коли документ відкривається компонентом Aspose, макроси не запускаються автоматично. Компоненти Aspose створені з метою дозволити розробникам створювати, маніпулювати та зберігати файли Office. Жоден з ризиків, пов’язаних з пакетом Microsoft Office, не притаманний компонентам Aspose.

Стабільність

Нижче наведено прямий цитат з вищезгаданої статті Microsoft:

"Office 2000, Office XP та Office 2003 використовують технологію Microsoft Windows Installer (MSI) для спрощення встановлення та саморемонту для кінцевого користувача. MSI вводить концепцію «встановити при першому використанні», що дозволяє динамічно встановлювати чи налаштовувати функції під час виконання (для системи або, частіше, для конкретного користувача). У серверному середовищі це уповільнює продуктивність і збільшує ймовірність появи діалогового вікна, яке просить користувача схвалити встановлення або надати відповідний інсталяційний диск. Хоча це призначено для підвищення стійкості Office як продукту для кінцевих користувачів, реалізація можливостей MSI в Office є контрпродуктивною у серверному середовищі. Крім того, стабільність Office загалом не може бути гарантована при роботі на сервері, оскільки вона не була розроблена або протестована для такого використання. Використання Office як сервісного компонента на мережевому сервері може знизити стабільність цього комп’ютера і, відповідно, усієї мережі. Якщо ви плануєте автоматизувати Office на сервері, спробуйте ізолювати програму на спеціальному комп’ютері, який не впливатиме на критичні функції, і який можна перезапускати за потреби."

Оскільки компоненти Aspose упаковані в один DLL, ніколи не буде необхідності встановлювати будь‑які додаткові частини чи фрагменти для їх функціонування. Компоненти Aspose використовуються лише .NET‑застосунками і не містять коду, що очікує людської реакції. Компоненти Aspose ретельно протестовані. Компоненти Aspose використовують такі компанії, як IBM, Hilton, Reader’s Digest, Bank of America та багато інших.

Масштабованість/Швидкість

Нижче наведено прямий цитат з вищезгаданої статті Microsoft:

"Компоненти серверної сторони повинні бути високоперезапускними, багатопоточними COM‑компонентами з мінімальними накладними витратами та високою пропускною здатністю для багатьох клієнтів. Прикладні програми Office майже у всіх відношеннях є навпаки. Вони не перезапускні, сервери автоматизації на базі STA, призначені для надання різноманітної, але ресурсомісткої функціональності для одного клієнта. Вони мають низьку масштабованість як серверне рішення і мають фіксовані обмеження важливих елементів, таких як пам’ять, які не можна змінити через налаштування. Більше того, вони використовують глобальні ресурси (наприклад, файли, що мапуються в пам’ять, глобальні надбудови або шаблони та спільні сервери автоматизації), що може обмежити кількість одночасно працюючих екземплярів і спричинити гонки, якщо вони налаштовані в багатоклієнтському середовищі. Розробники, які планують запускати більше одного екземпляру будь‑якої програми Office одночасно, повинні розглядати «пулінг» або серіалізацію доступу до програми Office, аби уникнути потенційних блокувань або пошкодження даних."

Компоненти Aspose надзвичайно масштабовані і блискавично швидкі. Прикладні програми Office не були розроблені для одночасного використання сотнями чи тисячами користувачів; натомість компоненти Aspose створені саме для цього. Наші компоненти є справжнім .NET‑рішенням і працюють бездоганно як на одному сервері, що обслуговує один застосунок, так і на навантажено‑балансованій веб‑фермі, що підтримує корпоративний застосунок.

Ціна

Коли застосунок використовує автоматизацію Microsoft Office, копія Microsoft Office повинна бути придбана для кожної машини, на якій запускається застосунок. Часто застосунок потребує створювати або маніпулювати файлом Office, не вимагаючи, щоб користувач мав Office. Aspose пропонує дуже економічну, безроялти, ліцензію на розповсюдження, яка дозволяє розгортати рішення на необмежену кількість користувачів без проблем з ліцензуванням.

При створенні веб‑застосунків важливо знати, що компоненти автоматизації Microsoft Office не цінуються і не ліцензуються для серверних рішень (Ліцензування веб‑компонентів Office 2000 та розширень Office Server); тому немає хорошого рішення з ліцензуванням для розгортання веб‑застосунків, що використовують компоненти Microsoft Office. Aspose також пропонує дуже економічне рішення для серверних застосунків.

Функції

Компоненти Aspose забезпечують усе необхідне для керування файлами Office, а також багато‑багато іншого. Вони розроблені за принципом надання розробникам можливості досягати найкращих результатів з мінімальними зусиллями. На відміну від автоматизації Office, компоненти Aspose пропонують багато потужних, економлячих час функцій. Наприклад, Aspose.Cells надає розробникам можливість експортувати дані з DataTable або DataView безпосередньо у файл Excel. Aspose.Words пропонує подібну функцію, що дозволяє заповнювати документ Word злиття листів безпосередньо з будь‑якого .NET‑об’єкта даних. Кожен компонент сімейства Aspose пропонує свій унікальний набір потужних можливостей.

Найкраща частина придбання компонента Aspose або комплекту компонентів — це доступ до наших команд розробників. Наші команди розуміють, що якщо ваша компанія потребує певної функції, то, швидше за все, іншим компаніям вона також знадобиться. Хоча не кожен запит на функцію може бути реалізований, наші команди намагаються залишатися відкритими та гнучкими при наданні підтримки. Такий підхід і дозволив компонентам Aspose стати настільки потужними. Якщо вам потрібні додаткові функції від об’єктів автоматизації Office, ваші шанси на їх додавання дуже, дуже низькі.

Висновок

У цій статті викладено основні причини, чому компоненти Aspose є кращим вибором порівняно з автоматизацією Office. Усі різні компоненти Aspose пропонують безризикову оцінювальну версію без зобов’язань. Ми закликаємо вас скористатися цією оцінкою, щоб побачити, що Aspose може зробити для ваших застосувань.

Для отримання додаткової інформації перегляньте такі інтернет‑статті:

Net: Відомі проблеми

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

Aspose.Email для .NET надає широкий спектр можливостей для маніпулювання MS Outlook, а також іншими популярними форматами повідомлень. Він також забезпечує велику підтримку комунікаційних протоколів, таких як POP3, IMAP, SMTP та протоколів Exchange Server, тобто WebDav і Exchange Web Service (EWS). Однак існують певні обмеження та відомі проблеми, які слід мати на увазі під час використання API. На сьогодні API підтримує конвертацію форматів OST у PST, за винятком OST 2013/2016.

Net: Системні вимоги

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

Вимоги до системи для Aspose.Email для .NET

Aspose.Email для .NET — це універсальний і потужний API, що надає комплексні можливості обробки електронної пошти для .NET‑додатків. Щоб забезпечити оптимальну продуктивність і сумісність, необхідно відповідати таким системним вимогам:

Підтримувані операційні системи

Windows:
- Windows 11
- Windows 10
- Windows 8 and 8.1
- Windows 7
- Windows Server 2022
- Windows Server 2019
- Windows Server 2016
- Windows Server 2012 та 2012 R2
- Windows Server 2008 та 2008 R2
Linux:
- Будь‑який сучасний дистрибутив Linux з підтримкою .NET Core
macOS:
- macOS з підтримкою .NET Core

Підтримувані .NET Framework

.NET Framework:
- .NET Framework 4.0 або новіший
.NET Core:
- .NET Core 2.0 або новіший
.NET 5 та .NET 6

Середовища розробки

Aspose.Email for .NET можна використовувати з будь‑яким з наступних інтегрованих середовищ розробки (IDE):

Microsoft Visual Studio:
- Visual Studio 2022
- Visual Studio 2019
- Visual Studio 2017
- Visual Studio 2015
- Visual Studio 2013
Інші IDE:
- JetBrains Rider
- SharpDevelop
- MonoDevelop

Вимоги до апаратного забезпечення

Нижче наведено мінімальні апаратні вимоги для ефективної роботи Aspose.Email for .NET:

Процесор:
- Процесор x86 або x64 з частотою 1 ГГц або вище
Пам’ять:
- 512 МБ ОЗУ (рекомендовано 1 ГБ або більше для кращої продуктивності)
Дисковий простір:
- 100 МБ вільного простору на жорсткому диску для установки
- Для даних застосунку та тимчасових файлів потрібен додатковий дисковий простір.

Додаткові вимоги до програмного забезпечення

Протоколи електронної пошти:
- Підтримуються IMAP, POP3, SMTP та Exchange Web Services (EWS).
- Для доступу та обробки пошти з різних поштових серверів переконайтеся, що налаштовано відповідні мережеві параметри та налаштування безпеки.
Бібліотеки та залежності:
- Переконайтеся, що всі необхідні бібліотеки та залежності .NET встановлені та правильно налаштовані.
- Для застосунків, що використовують .NET Core або Mono, слід встановити відповідні середовища виконання та бібліотеки розробки.

Net: Встановлення

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

Встановлення Aspose.Email для .NET через NuGet

NuGet — найпростіший спосіб завантажити та встановити Aspose API для .NET.

Використання графічного інтерфейсу NuGet Package Manager

Відкрийте ваш проєкт у Visual Studio і перейдіть до опції «Manage NuGet Packages», клацнувши правою кнопкою миші на вашому проєкті в Solution Explorer.

У NuGet Package Manager у вкладці Browse шукайте "Aspose.Email".
Після того, як знайдете пакет Aspose.Email, натисніть кнопку «Install», щоб додати його до вашого проєкту.

Використання Package Manager Console

Ви можете легко завантажити та інтегрувати бібліотеку Aspose.Email у ваш проєкт, отримавши доступ до її всебічних функцій управління електронною поштою, виконавши команду ‘Install-Package Aspose.Email’ у Package Manager Console.

Відкрийте ваше рішення/проєкт у Visual Studio.
Виберіть Tools -> NuGet Package Manager -> Package Manager Console.
Введіть команду ‘Install-Package Aspose.Email’ і натисніть Enter.

NuGet гарантує, що ви отримаєте останню версію пакету, включаючи всі поточні оновлення та виправлення.

Оновити Aspose.Email за допомогою Package Manager Console

Ви можете оновити Aspose.Email за допомогою Package Manager Console у Visual Studio:

Відкрийте ваше рішення/проєкт у Visual Studio.
Виберіть Tools -> NuGet Package Manager -> Package Manager Console.

У консолі переконайтеся, що у випадаючому списку «Default project» вибрано правильний проєкт. Далі виконайте команду Update-Package Aspose.Email, щоб завантажити та встановити останню версію бібліотеки Aspose.Email. Ця команда оновить пакет і його залежності до найновішої версії, забезпечуючи ваш проєкт актуальними функціями та покращеннями, які пропонує Aspose.Email.

Як варіант, ви можете додати суфікс "-prerelease" до команди, щоб також встановити останній випуск, включаючи виправлення.

Встановити Aspose.Email для .NET на Linux

Для встановлення бібліотеки за допомогою .NET CLI на будь‑якій платформі, включаючи Linux:

Відкрийте термінал. Переконайтеся, що на вашій машині встановлений .NET SDK. Перевірити це можна, виконавши:

dotnet --version

Створіть новий проєкт. Перейдіть у каталог, в якому хочете створити проєкт, і виконайте команду dotnet new. Наприклад:

dotnet new console -n AsposeEmailApp

Це створить новий каталог під назвою MyConsoleApp із необхідними файлами для консольного застосунку.

Перейдіть у каталог проєкту.

cd AsposeEmailApp

Додайте пакет Aspose.Email. Використайте команду dotnet add package, щоб додати Aspose.Email з NuGet:

dotnet add package Aspose.Email

Виконавши ці кроки, ви завантажите та встановите останню версію Aspose.Email для .NET з NuGet і додасте її до залежностей вашого проєкту. Після завершення встановлення ви зможете використовувати бібліотеку у вашому .NET‑проєкті на Linux.

Net: Ліцензування та обмеження

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

Оцінка Aspose.Email

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

Якщо ви хочете протестувати Aspose.Email без обмежень оцінної версії, ви також можете запросити 30‑денну тимчасову ліцензію. Будь ласка, ознайомтеся з Як отримати тимчасову ліцензію?

Обмеження оцінкової версії

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

Файл License.txt додається до файлу повідомлення, що зберігається за допомогою Aspose.Email
Лише 50 електронних листів можна витягнути з папки у файлі PST
Лише 3 вкладення та вбудовані зображення можна витягнути з файлу MSG
Максимальна кількість оброблених вкладень у форматі CFB — 1
Максимальна кількість оброблених одержувачів у форматі CFB — 1
Додає "Evaluation Message" у рядок Тема під час збереження у форматах CFB, EML або MSG
Дата завершення не може бути пізнішою за 31‑12‑2004 у методі GenerateOccurrences шаблону повторень. Це дозволяє тестувати продукт у значущий спосіб, проте неможливо використати у виробничому застосунку. Наприклад, ви можете створити шаблон "почати 1 січня 2000 року і повторюватися кожного останнього робочого дня місяця" і згенерувати його випадки. Випадки після 31 грудня 2004 року не будуть згенеровані в оцінковому режимі.
Додає "Evaluation Watermark Image" під час збереження у форматах XPS або TIFF.
Максимальна кількість неоднозначних електронних адрес та імен, розв’язаних MS Exchange Server, становить 20
Максимальна довжина файлу даних, дозволеного для перетягування у FileDropPanel, становить 51200 байт
Показує діалогове вікно з повідомленням "Evaluation Message" під час операції перетягування, використаної FileDropPanel
Лише 1 файл витягується з заданого MSO‑потоку методом InlineAttachmentExtractor.EnumerateMsoPackage

Застосування ліцензії

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

Про ліцензію

Ліцензія — це простий XML‑текстовий файл, який містить такі дані, як назва продукту, кількість розробників, яким вона надана, дата закінчення підписки тощо. Файл підписаний цифровим підписом, тому не змінюйте його. Навіть випадкове додання зайвого символу переносу рядка зробить файл недійсним.

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

Застосування ліцензії за допомогою файлу або потоку

Налаштування ліцензії в Aspose.Email для .NET

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

Явний шлях
Папка, що містить dll компонента (включено в Aspose.Email)
Папка, що містить збірку, яка викликала dll компонента (включений в Aspose.Email)
Папка, що містить головну збірку (ваш .exe)
Вбудований ресурс у збірці, яка викликала dll компонента (включений в Aspose.Email). Існує два поширені методи встановлення ліцензії, які описані нижче:

Застосування ліцензії за допомогою файлу або об’єкта потоку

Найпростіший спосіб встановити ліцензію — розмістити ліцензійний файл у тій самій папці, що й dll компонента (включеного в Aspose.Email), і вказати лише ім’я файлу без шляху.


 // Instantiate an instance of license and set the license file through its path

Aspose.Email.License license = new Aspose.Email.License();

license.SetLicense("Aspose.Email.lic");


 // Instantiate an instance of license and set the license through a stream

Aspose.Email.License license = new Aspose.Email.License();

license.SetLicense(myStream);

Коли ви викликаєте метод SetLicense, назва ліцензії повинна збігатися з назвою вашого файлу ліцензії. Наприклад, ви можете змінити назву файлу ліцензії на "Aspose.Email.lic.xml". Тоді у вашому коді слід використовувати змінену назву ліцензії (тобто Aspose.Email.lic.xml) у методі SetLicense.

Застосувати лічену ліцензію

Aspose.Email дозволяє розробникам застосовувати метered‑ключ. Це новий механізм ліцензування. Новий механізм буде використовуватись разом із існуючим методом ліцензування. Клієнти, які хочуть оплачувати використання функцій API, можуть користуватись метered‑ліцензуванням. Для більш детальної інформації, будь ласка, зверніться до FAQ щодо метered‑ліцензування розділ.

Був представлений новий клас Metered для застосування метered‑ключа. Нижче наведено зразковий код, що демонструє, як встановити публічний та приватний метered‑ключі.

Включення файлу ліцензії як вбудованого ресурсу

Ще один зручний спосіб упакувати ліцензію разом із вашим застосунком і гарантувати, що вона не буде втрачена, — включити її як вбудований ресурс в одну з збірок, яка викликає dll компонента (включено в Aspose.Email). Щоб включити файл ліцензії як вбудований ресурс, виконайте наступні кроки:

У Visual Studio .NET включіть файл ліцензії (.lic) у проєкт за допомогою меню File | Add Existing Item…
Виберіть файл у Solution Explorer і встановіть Build Action у Embedded Resource у вікні Properties
Щоб отримати доступ до ліцензії, вбудованої в збірку (як вбудований ресурс), не потрібно викликати методи GetExecutingAssembly та GetManifestResourceStream класу System.Reflection.Assembly у Microsoft .NET Framework. Все, що потрібно зробити, — це додати файл ліцензії як вбудований ресурс у ваш проєкт і передати назву файлу ліцензії в метод SetLicense. Клас License автоматично знайде файл ліцензії у вбудованих ресурсах.

Будь ласка, перегляньте наведений нижче приклад, щоб зрозуміти цей спосіб встановлення ліцензії (вбудованої) у ваші застосунки.


 // Instantiate the License class

Aspose.Email.License license = new Aspose.Email.License();

// Pass only the name of the license file embedded in the assembly

license.SetLicense("Aspose.Email.lic");

Як перевірити номер версії Aspose.Email для .NET

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

Використання API для перевірки номера версії

Aspose.Email для .NET надає простий спосіб отримати номер версії програмно. Ви можете отримати цю інформацію через BuildVersionInfo клас.

Наступний фрагмент коду C# для отримання та відображення номера версії:


using System;
using Aspose.Email;

class Program
{
    static void Main(string[] args)
    {
        // Get the version number of Aspose.Email for .NET
        string version = BuildVersionInfo.AssemblyVersion;
        
        // Display the version number
        Console.WriteLine("Aspose.Email for .NET Version: " + version);
    }
}

Перевірка номера версії у Visual Studio

Ви також можете перевірити номер версії безпосередньо у Visual Studio без написання коду:

Solution Explorer:

Відкрийте ваш проєкт у Visual Studio.
Перейдіть до Solution Explorer.
Розкрийте вузол "References" у вашому проєкті.

Властивості посилання:

Знайдіть "Aspose.Email" у списку посилань.
Клацніть правою кнопкою миші "Aspose.Email" і виберіть "Properties".
У вікні Properties ви побачите номер версії, зазначений у властивості "Version".

Використання NuGet Package Manager

Якщо ви встановили Aspose.Email через NuGet, ви можете перевірити номер версії через NuGet Package Manager:

Package Manager Console:

Відкрийте Package Manager Console через Tools > NuGet Package Manager > Package Manager Console.
Введіть наступну команду, щоб отримати список встановлених пакетів:

Get-Package -Id Aspose.Email

Це відобразить номер версії пакету Aspose.Email, встановленого у вашому проєкті.

Керування пакетами NuGet:

Клацніть правою кнопкою миші ваш проєкт у Solution Explorer.
Виберіть "Manage NuGet Packages".
На вкладці "Installed" знайдіть "Aspose.Email", щоб побачити номер версії.

Перевірка номера версії у властивостях DLL

Ви також можете перевірити номер версії, досліджуючи властивості Aspose.Email DLL:

Знайти DLL:

Знайдіть файл Aspose.Email DLL у каталозі вашого проєкту, зазвичай у папці bin.

Переглянути властивості:

Клацніть правою кнопкою миші файл Aspose.Email DLL і виберіть "Properties".
Перейдіть на вкладку "Details". Номер версії буде відображений у полі "Product version" або "File version".

Слідуючи будь-якому з цих методів, ви можете легко перевірити номер версії Aspose.Email для .NET, переконавшись, що у вас правильна версія для ваших потреб у розробці. Для подальшої допомоги та оновлень звертайтеся до Aspose.Email для .NET документація.

Net: Як запустити приклади

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

Вимоги до ПЗ

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

Visual Studio 2010 або вище
Менеджер пакетів NuGet встановлений у Visual Studio. Переконайтеся, що встановлена остання версія API NuGet у Visual Studio. Для детальної інструкції щодо встановлення менеджера пакетів NuGet перегляньте https://docs.microsoft.com/en-us/nuget/install-nuget-client-tools
Перейдіть у Tools->Options->NuGet Package Manager->Package Sources і переконайтеся, що опція nuget.org позначена
Проєкт прикладу використовує функцію автоматичного відновлення пакетів NuGet, тому вам потрібне активне інтернет-з’єднання.

Завантажити з GitHub

Усі приклади Aspose.Font для .NET розміщені на GitHub.

Ви можете клонувати репозиторій за допомогою улюбленого клієнта GitHub або завантажити ZIP-файл з тут.
Розпакуйте вміст ZIP‑файлу у будь‑яку папку на вашому комп’ютері. Усі приклади розташовані у папці Examples.
Проєкти створені у Visual Studio 2013, проте файли рішення сумісні з Visual Studio 2010 SP1 та вище.
Відкрийте файл рішення у Visual Studio та збілдьте проєкт.
При першому запуску залежності будуть автоматично завантажені через NuGet.
Папка Data у кореневій директорії Examples містить вхідні файли. Обов’язково завантажте папку Data разом із проєктом прикладів.
Відкрийте RunExamples.cs, звідси викликаються всі приклади.
Розкоментуйте приклади, які ви хочете запустити у проєкті.

Будь ласка, звертайтесь до наших форумів, якщо у вас виникли проблеми з налаштуванням або запуском прикладів.

Внести внесок

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

Щоб внести свій внесок, ви можете форкнути репозиторій, відредагувати вихідний код і створити pull request. Ми переглянемо зміни і включимо їх у репозиторій, якщо вони будуть корисними.

Net: Тарифний план

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

Aspose.Email дозволяє розробникам виконувати завдання, пов’язані з електронною поштою, у вебзастосунках/службах ASP.NET або Windows-застосунках.

Будь ласка, перевірте Тарифний план і Типи ліцензій веб-сторінка, яка дає огляд наших тарифних планів та переваг використання придбаної Aspose.Email.

Net: Підтримка продукту

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

Технічна підтримка

Очікуючи відповідь у форумах, будь ласка, враховуйте різницю часових поясів.

Повідомлення про проблему

Якщо у вас є проблема, дотримуйтесь цих простих кроків, щоб забезпечити ефективне вирішення:

Переконайтеся, що ви використовуєте останню версію продукту перед повідомленням про проблему. Дивіться Сторінка завантаження Aspose.Email for .NET щоб дізнатися про останню версію.
Ознайомтеся з форуми, ця Wiki документація та Посилання на API перед подачею проблеми. На ваше питання вже може бути відповідь.
При повідомленні про проблему, будь ласка, включіть оригінальний документ і, можливо, фрагмент вашого коду, який викликає проблему. Якщо потрібно прикріпити декілька файлів, заархівуйте їх в один. Безпечно прикріплювати документи у форумах, оскільки доступ до файлів мають лише ви та розробники Aspose.
Будь ласка, намагайтеся повідомляти про одну проблему в одному темі. Якщо у вас є інша проблема, повідомте про неї в окремій темі.

Ресурси

У цій таблиці перераховано важливі технічні ресурси Aspose.Email для .NET.

Documentation – Початок роботи

Net: Огляд продукту

Опис продукту

Що робить Aspose.Email for .NET видатним?

Технічна підтримка

Повідомлення про проблему

Net: Підтримувані протоколи та сервіси

Net: Підтримувані формати файлів

Net: Як запустити Aspose.Email

Hello World

Запустити Aspose.Email для .NET на Linux

Net: Огляд функцій

Aspose.Email

Aspose.Email.Amp

Aspose.Email.AntiSpam

Aspose.Email.Bounce

Aspose.Email.Calendar

Aspose.Email.Clients.DeliveryService.Mailgun

Aspose.Email.Clients.DeliveryService.SendGrid

Aspose.Email.Clients.Exchange.Dav

Aspose.Email.Clients.Exchange.WebService

Aspose.Email.Clients.Google

Aspose.Email.Clients.Graph

Aspose.Email.Clients.Imap

Aspose.Email.Clients.Pop3

Aspose.Email.Clients.Smtp

Aspose.Email.DKIM

Aspose.Email.Mapi

Aspose.Email.PersonalInfo.VCard

Aspose.Email.Printing

Aspose.Email.Storage.Mbox

Aspose.Email.Storage.Olm

Aspose.Email.Storage.Pst

Aspose.Email.Storage.Zimbra

Aspose.Email.Tools.Logging

Aspose.Email.Tools.Merging

Aspose.Email.Tools.Search

Aspose.Email.Tools.Verifications

Aspose.Email.Windows.Forms

Aspose.Email.Windows.WPF

Net: Чому не автоматизація

Безпека

Стабільність

Масштабованість/Швидкість

Ціна

Функції

Висновок

Net: Відомі проблеми

Net: Системні вимоги

Вимоги до системи для Aspose.Email для .NET

Підтримувані операційні системи

Підтримувані .NET Framework

Середовища розробки

Вимоги до апаратного забезпечення

Додаткові вимоги до програмного забезпечення

Рекомендовані конфігурації

Net: Встановлення

Встановлення Aspose.Email для .NET через NuGet

Використання графічного інтерфейсу NuGet Package Manager

Використання Package Manager Console

Оновити Aspose.Email за допомогою Package Manager Console

Встановити Aspose.Email для .NET на Linux

Net: Ліцензування та обмеження

Оцінка Aspose.Email

Обмеження оцінкової версії

Застосування ліцензії

Про ліцензію

Застосування ліцензії за допомогою файлу або потоку

Налаштування ліцензії в Aspose.Email для .NET

Застосування ліцензії за допомогою файлу або об’єкта потоку

Застосувати лічену ліцензію

Включення файлу ліцензії як вбудованого ресурсу

Як перевірити номер версії Aspose.Email для .NET

Використання API для перевірки номера версії

Перевірка номера версії у Visual Studio

Використання NuGet Package Manager

Перевірка номера версії у властивостях DLL

Net: Як запустити приклади

Вимоги до ПЗ

Завантажити з GitHub