Работа с вложениями и встроенными объектами

Управление вложениями электронной почты

Вложение электронной почты - это файл, который отправляется вместе с электронным сообщением. Файл может быть отправлен как отдельное сообщение, так и частью сообщения, к которому он прикреплен. Класс Attachment используется совместно с классом MailMessage. Все сообщения включают текстовое содержание. В дополнение к содержимому вы можете отправлять дополнительные файлы. Они отправляются в виде вложений и представлены как экземпляры класса Attachment. Вы можете отправить любое количество вложений, но размер вложения ограничен почтовым сервером. Gmail, например, не поддерживает размеры файлов более 10 МБ.

Попробуйте это!

Добавьте или удалите вложения электронной почты онлайн с помощью бесплатного Aspose.Email Editor App.

Добавление вложения

Чтобы добавить вложение к электронной почте, выполните следующие шаги:

Создайте экземпляр класса MailMessage.
Создайте экземпляр класса Attachment.
Загрузите вложение в экземпляр Attachment.
Добавьте экземпляр Attachment в экземпляр MailMessage.

Следующий фрагмент кода показывает, как добавить вложение к электронному письму.

// Создайте экземпляр класса MailMessage
var eml = new MailMessage
{
    From = "sender@from.com",
    To = "receiver@to.com",
    Subject = "Это сообщение",
    Body = "Это содержимое"
};

// Загрузите вложение
var attachment = new Attachment("1.txt");

// Добавьте несколько вложений в экземпляр класса MailMessage и сохраните сообщение на диск
eml.Attachments.Add(attachment);

eml.AddAttachment(new Attachment("1.jpg"));
eml.AddAttachment(new Attachment("1.doc"));
eml.AddAttachment(new Attachment("1.rar"));
eml.AddAttachment(new Attachment("1.pdf"));
eml.Save("AddAttachments.eml");

Выше мы описали, как добавить вложения к вашему электронному сообщению с помощью Aspose.Email. Следующий раздел показывает, как удалить вложения и отобразить информацию о них на экране.

Добавление ссылочного вложения

Ссылочное вложение - это тип вложения, который включает ссылку или указание на файл или элемент, а не включает сам файл или элемент в сообщение электронной почты. Когда получатели электронной почты кликают на ссылочное вложение, они смогут получить доступ к связанному файлу, если у них есть соответствующие разрешения. Используя ссылочное вложение, вы можете отправить меньшее сообщение и убедиться, что все имеют доступ к самой актуальной версии файла или элемента.

Ниже приведен пример кода, показывающий, как добавить ссылочное вложение к электронному письму. Код выполняет следующие шаги:

Загружает файл электронного сообщения, используя метод MailMessage.Load().
Создает новый объект ReferenceAttachment под названием refAttach, передавая URL вложения “https://[attach_uri]” в качестве параметра его конструктора.
Устанавливает имя вложения на “Document.docx” с помощью свойства Name объекта refAttach.
Устанавливает тип провайдера вложения на AttachmentProviderType.OneDrivePro с помощью свойства ProviderType объекта refAttach.
Устанавливает тип разрешения вложения на AttachmentPermissionType.AnyoneCanEdit с помощью свойства PermissionType объекта refAttach.
Добавляет объект refAttach в коллекцию Attachments объекта eml, используя метод Add().

var eml = MailMessage.Load("fileName");

var refAttach = new ReferenceAttachment("https://[attach_uri]")
{
    Name = "Document.docx",
    ProviderType = AttachmentProviderType.OneDrivePro,
    PermissionType = AttachmentPermissionType.AnyoneCanEdit
};

eml.Attachments.Add(refAttach);

Удаление вложения

Чтобы удалить вложение, выполните следующие шаги:

Создайте экземпляр класса Attachment.
Загрузите вложение в экземпляр класса Attachment.
Добавьте вложение в экземпляр класса MailMessage.
Удалите вложение из экземпляра класса Attachment с использованием экземпляра класса MailMessage.

Следующий код показывает, как удалить вложение.

// Создайте экземпляр класса MailMessage
var eml = new MailMessage {From = "sender@sender.com", To = "receiver@gmail.com"};

// Загрузите вложение
var attachment = new Attachment("1.txt");
eml.Attachments.Add(attachment);

// Удалите вложение из вашего MailMessage
eml.Attachments.Remove(attachment);

Отображение имени файла вложения

Чтобы отобразить имя файла вложения, выполните следующие шаги:

Пройдитесь по вложениям в электронном сообщении и сохраните каждое вложение.
Отобразите каждое имя вложения на экране.

Следующий фрагмент кода показывает, как отобразить имя файла вложения на экране.

var eml = MailMessage.Load("Attachments.eml");

foreach (var attachment in eml.Attachments)
{
    // Отобразите имя файла вложения
    Console.WriteLine(attachment.Name);
}

Извлечение вложений электронной почты

Эта тема объясняет, как извлечь вложение из файла электронной почты. Вложение электронной почты - это файл, который отправляется вместе с электронным сообщением. Файл может быть отправлен как отдельное сообщение, так и частью сообщения, к которому он прикреплен. Все электронные сообщения включают возможность отправки дополнительных файлов. Они отправляются в виде вложений и представлены как экземпляры класса Attachment. Класс Attachment используется с классом MailMessage для работы с вложениями. Чтобы извлечь вложения из электронного сообщения, выполните следующие шаги:

Создайте экземпляр класса MailMessage.
Загрузите файл электронной почты в экземпляр MailMessage.
Создайте экземпляр класса Attachment и используйте его в цикле для извлечения всех вложений.
Сохраните вложение и отобразите его на экране.

Извлеченные вложения в электронной почте

Следующий фрагмент кода показывает, как извлечь вложения электронной почты.

var eml = MailMessage.Load("Message.eml", new MsgLoadOptions());

foreach (var attachment in eml.Attachments)
{
    attachment.Save("MessageEmbedded_out.eml");
    Console.WriteLine(attachment.Name);
}

Извлечение содержимого описания из вложения

API Aspose.Email предоставляет возможность считывать содержимое описания вложения из заголовка вложения. Следующий фрагмент кода показывает, как извлечь описание содержимого из вложения.

var eml = MailMessage.Load("EmailWithAttachEmbedded.eml");
Console.WriteLine(eml.Attachments[0].Headers["Content-Description"]);

Определение, является ли вложение встроенным сообщением

Следующий фрагмент кода демонстрирует, как определить, является ли вложение встроенным сообщением или нет.

var eml = MailMessage.Load("EmailWithAttachEmbedded.eml");

Console.WriteLine(eml.Attachments[0].IsEmbeddedMessage
    ? "Вложение является встроенным сообщением."
    : "Вложение не является встроенным сообщением.");

Работа с встроенными изображениями

Добавление встроенного изображения в тело электронной почты

Класс LinkedResource используется совместно с классом MailMessage для встраивания объектов в ваше электронное сообщение. Чтобы добавить встроенный объект, выполните следующие шаги:

Создайте экземпляр класса MailMessage.
Укажите значения от кого, кому и тему в экземпляре MailMessage.
Создайте экземпляр класса AlternateView.
Создайте экземпляр класса LinkedResource.
Загрузите встроенный объект в LinkedResourceCollection.
Добавьте загруженный встроенный объект в экземпляр класса MailMessage.
Добавьте экземпляр AlternateView в экземпляр класса MailMessage.

Ниже приведены фрагменты кода, которые создают электронное сообщение с текстовым и HTML содержанием и изображением, встроенным в HTML.

Изображение, встроенное в электронное письмо

Вы можете отправить любое количество встроенных объектов. Размер вложения ограничен почтовым сервером. Gmail, например, не поддерживает размеры файлов более 10 МБ. Ниже приведены фрагменты кода, демонстрирующие, как встроить объекты в электронную почту.

var eml = new MailMessage
{
    From = "AndrewIrwin@from.com",
    To = "SusanMarc@to.com",
    Subject = "Это электронное письмо"
};

// Создайте часть с простым текстом. Она будет доступна тем клиентам, которые не поддерживают HTML.
var plainView =
    AlternateView.CreateAlternateViewFromString("Это мое содержание в простом тексте", null, "text/plain");

// Создайте HTML часть. Чтобы встроить изображения, нужно использовать префикс 'cid' в значении img src.
// Значение cid будет соответствовать Content-Id связанного ресурса. Таким образом, <img src='cid:barcode'>
// будет соответствовать LinkedResource с ContentId 'barcode'.
var htmlView =
    AlternateView.CreateAlternateViewFromString("Вот встроенное изображение.<img src=cid:barcode>", null,
        "text/html");

// Создайте LinkedResource (встроенное изображение) и добавьте LinkedResource в соответствующий вид.
var barcode = new LinkedResource("1.jpg", MediaTypeNames.Image.Jpeg)
{
    ContentId = "barcode"
};

eml.LinkedResources.Add(barcode);
eml.AlternateViews.Add(plainView);
eml.AlternateViews.Add(htmlView);

eml.Save("EmbeddedImage_out.msg", SaveOptions.DefaultMsgUnicode);

Удаление встроенного изображения из тела электронной почты

LinkedResourceCollection доступна через свойство MailMessage.LinkedResources. Коллекция LinkedResourceCollection предоставляет метод для полного удаления встроенных объектов, добавленных в электронное сообщение. Используйте перегруженную версию метода LinkedResourceCollection.RemoveAt для удаления всех следов встроенного объекта из электронного сообщения.

Примерный код ниже показывает, как удалить встроенные объекты из электронного сообщения.

// Загрузите тестовое сообщение с связанными ресурсами
var eml = MailMessage.Load("EmlWithLinkedResources.eml");

// Удалите LinkedResource
eml.LinkedResources.RemoveAt(0, true);

// Теперь очистите альтернативный вид для связанных ресурсов
eml.AlternateViews[0].LinkedResources.Clear(true);

Работа с встроенными объектами

Встроенный объект - это объект, который был создан в одном приложении и заключен в документ или файл, созданный другим приложением. Например, электронная таблица Microsoft Excel может быть встроена в отчет Microsoft Word, или видеофайл может быть встроен в презентацию Microsoft PowerPoint. Когда файл встраивается, а не вставляется или копируется в другой документ, он сохраняет свой оригинальный формат. Встроенный документ может быть открыт в оригинальном приложении и изменен.

Извлечение встроенных объектов

Эта тема объясняет, как извлечь встроенные объекты из файла электронной почты. Встроенный документ может быть открыт в оригинальном приложении и изменен. Чтобы извлечь встроенный объект из электронного сообщения, выполните следующие шаги:

Создайте экземпляр класса MailMessage.
Загрузите файл электронной почты в экземпляр MailMessage.
Создайте цикл и создайте экземпляр класса Attachment в нем.
Сохраните вложение и отобразите его на экране.
Укажите адреса отправителя и получателя в экземпляре MailMessage.
Отправьте электронную почту с помощью класса SmtpClient.

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

Извлеченные встроенные объекты в электронной почте

Следующий фрагмент кода показывает, как извлечь встроенные объекты.

var eml = MailMessage.Load("Message.msg", new MsgLoadOptions());

foreach (var attachment in eml.Attachments)
{
    attachment.Save("MessageEmbedded_out.msg");
    Console.WriteLine(attachment.Name);
}

Идентификация и извлечение встроенного вложения из формата MSG как RTF

Для сообщений, отформатированных как RTF, следующий код может быть использован для различения и извлечения вложений, которые являются либо встроенными, либо появляются в виде иконки в теле сообщения. Следующий фрагмент кода показывает, как идентифицировать и извлечь встроенное вложение из MSG формата RTF.


var eml = MapiMessage.Load("MSG file with RTF Formatting.msg");

foreach (var attachment in eml.Attachments)
{
    if (IsAttachmentInline(attachment))
    {
        try
        {
            SaveAttachment(attachment, Data.Out/new Guid().ToString());
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

static bool IsAttachmentInline(MapiAttachment attachment)
{
    foreach (var property in attachment.ObjectData.Properties.Values)
    {
        if (property.Name == "\x0003ObjInfo")
        {
            var odtPersist1 = BitConverter.ToUInt16(property.Data, 0);
            return (odtPersist1 & (1 << (7 - 1))) == 0;
        }
    }
    return false;
}

static void SaveAttachment(MapiAttachment attachment, string fileName)
{
    foreach (var property in attachment.ObjectData.Properties.Values)
    {
        if (property.Name == "Package")
        {
            using var fs = new FileStream(fileName, FileMode.Create, FileAccess.Write);
            fs.Write(property.Data, 0, property.Data.Length);
        }
    }
}

Извлечение вложений из подписанного электронного письма

Подписанные электронные письма содержат одно вложение smime.p7m. Это означает, что электронное письмо зашифровано с использованием SMIME. Формат файла Smime.p7m является цифровой подписью. Чтобы увидеть содержимое этого электронного письма, используйте метод RemoveSignature. Метод возвращает объект MailMessage без цифровой подписи.

var signedEml = MailMessage.Load("signed.eml");
        
if (signedEml.IsSigned)
{
    for (var i = 0; i < signedEml.Attachments.Count; i++)
    {
        Console.WriteLine($@"Подписанное вложение электронного письма{i}: {signedEml.Attachments[i].Name}");
    }
    
    // Электронное письмо подписано. Удалите подпись.
    var eml = signedEml.RemoveSignature();
    
    Console.WriteLine(@"Подпись удалена.");

    for (var i = 0; i < eml.Attachments.Count; i++)
    {
        Console.WriteLine($@"Вложение электронного письма{i}: {eml.Attachments[i].Name}");
    }
}

Создание и установка содержимого электронных писем в .NET Извлечение содержимого сообщений из электронной почты