Работа с данными контактов в профессиональных приложениях часто требует преобразования между различными форматами. Обычный сценарий — преобразование контактов Outlook в веб‑дружественный формат для предварительного просмотра или совместного использования в браузере, а затем обратное преобразование их содержимого в формат VCF для хранения или повторного использования.

В этой статье демонстрируется, как использовать библиотеку Aspose.Email for .NET для выполнения этих преобразований на C#.

Повышайте эффективность конвертации контактов с помощью продвинутого .NET API

Aspose.Email for .NET — это мощная библиотека, позволяющая разработчикам создавать, изменять и конвертировать файлы Outlook (MSG, PST, OST), электронные письма, элементы календаря, списки рассылки и многое другое. В этой статье мы будем использовать её для конвертации:

  • Контакты Outlook VCF в HTML‑документы
  • HTML‑контент в объекты MapiContact

Начало работы

Начните с установки библиотеки в ваш проект с помощью NuGet Package Manager:

  1. Откройте ваш проект в Visual Studio.
  2. Перейдите к Tools > NuGet Package Manager > Manage NuGet Packages for Solution.
  3. Найдите Aspose.Email.
  4. Выберите пакет и нажмите Install.

В качестве альтернативы вы можете установить пакет через Package Manager Console, используя следующую команду:

Install-Package Aspose.Email

Вы также можете скачать последнюю версию API напрямую с сайта Aspose.

После установки вы готовы к работе.

Экспорт контактов VCF в HTML

Aspose.Email позволяет загружать VCF‑файл как MapiContact и затем экспортировать его в удобный для отображения макет с настраиваемыми параметрами, такими как включение деталей vCard и заголовков. Ниже приведён пример кода, демонстрирующий, как экспортировать VCF в HTML:

  1. Используйте метод FromVCard() для чтения файла .vcf и создания объекта MapiContact.
  2. Вызовите GetUnderlyingMessage() у объекта MapiContact, чтобы преобразовать его в объект MailMessage для дальнейшего экспорта.
  3. Настройте HtmlSaveOptions для управления форматированием экспортируемых данных:
  • Включите детали, специфичные для vCard, с помощью RenderVCardInfo.
  • Добавьте стандартный заголовок в стиле электронной почты с помощью WriteHeader .

Импорт HTML‑контента в контакт VCF

Вы также можете создать новый контакт Outlook из строки HTML и сохранить его как файл VCF. Это полезно, когда личные данные собираются или редактируются через веб‑форму или импортируются из веб‑шаблонов. Ниже приведён пример кода, демонстрирующий, как создать контакт из HTML:

  1. Загрузите содержимое HTML‑файла в строку.
  2. Инициализируйте MapiContact с отображаемым именем и адресом электронной почты.
  3. Присвойте загруженное содержимое контакту с помощью SetBodyContent(), указав тип содержимого как BodyContentType.Html.
  4. Сохраните результат в файл .vcf, используя формат ContactSaveFormat.VCard.

Заключение

Мы рассмотрели одну из расширенных возможностей библиотеки Aspose.Email for .NET в управлении электронной почтой. Вы узнали, как конвертировать контакты в HTML и из него, чтобы улучшить совместимость, упростить настройку и обеспечить лучший пользовательский опыт при отображении персональной информации. Используя наши API, вы можете выполнять эти задачи всего несколькими строками кода и иметь полный контроль над форматированием.

Дополнительные ресурсы

Чтобы максимально использовать API, ознакомьтесь со следующими ресурсами:

См. также