Trabajando con Archivos Adjuntos de Mensajes

Gestionando Adjuntos con Aspose Outlook

Crear y guardar archivos de mensaje de Outlook (MSG) explica cómo crear y guardar mensajes, y cómo crear archivos MSG con adjuntos. Este artículo explica cómo gestionar los adjuntos de Microsoft Outlook con Aspose.Email. Los adjuntos de un archivo de mensaje se acceden y guardan en disco utilizando la propiedad Attachments de la clase MapiMessage. La propiedad Attachments es una colección del tipo de la clase MapiAttachmentCollection.

Verificar si el Adjunto es Inline o Regular

Los adjuntos inline y regulares cumplen diferentes propósitos. Los adjuntos inline están integrados visualmente en el mensaje de correo electrónico y suelen ser imágenes o archivos multimedia. Mientras tanto, los adjuntos regulares son archivos separados que se adjuntan al correo electrónico y pueden incluir varios tipos de archivos. La propiedad MapiAttachment.IsInline de la clase MapiAttachment obtiene un valor que indica si el adjunto es inline o regular.

El siguiente ejemplo de código extrae y muestra información sobre cada adjunto en el MapiMessage cargado, incluyendo sus nombres para mostrar y si son adjuntos inline o no.

var message = MapiMessage.Load(fileName);

foreach (var attach in message.Attachments)
{
    Console.WriteLine($"{attach.DisplayName0} : {attach.IsInline)}");
}

Guardar Adjuntos desde el Archivo de Mensaje de Outlook (MSG)

Para guardar adjuntos de un archivo MSG:

  1. Iterar a través de la colección MapiAttachmentCollection y obtener los adjuntos individuales.
  2. Para guardar los adjuntos, llamar al método Save() de la clase MapiAttachment.

El siguiente fragmento de código te muestra cómo guardar adjuntos en el disco local.

Obteniendo Adjuntos de Mensajes de Correo Anidados

Los adjuntos OLE incrustados también aparecen en la colección de adjuntos de la clase MapiMessage. El siguiente ejemplo de código analiza un archivo de mensaje en busca de adjuntos de mensajes incrustados y los guarda en el disco. El método estático FromProperties() de la clase MapiMessage puede crear un nuevo mensaje a partir de un adjunto incrustado. El siguiente fragmento de código te muestra cómo obtener adjuntos de mensajes de correo anidados.

Eliminar Adjuntos

La biblioteca Aspose Outlook proporciona la funcionalidad para eliminar adjuntos de archivos de Microsoft Outlook Message (.msg):

  • Llama al método RemoveAttachments(). Toma la ruta del archivo de mensaje como parámetro. Está implementado como un método estático público, por lo que no necesitas instanciar el objeto.

El siguiente fragmento de código te muestra cómo eliminar adjuntos.

También puedes llamar al método estático DestoryAttachment() de la clase MapiMessage. Funciona más rápido que RemoveAttachment(), porque el método RemoveAttachment() analiza el archivo de mensaje.

Agregar Adjuntos MSG

Un mensaje de Outlook puede contener otros mensajes de Microsoft Outlook en adjuntos ya sea como mensajes regulares o incrustados. La MapiAttachmentCollection proporciona miembros sobrecargados del método Add para crear mensajes de Outlook con ambos tipos de adjuntos.

Agregar un Adjunto de Referencia en un MapiMessage

El método MapiAttachmentCollection.Add(string name, string sharedLink, string url, string providerName) de la clase MapiAttachmentCollection permite agregar un adjunto de referencia en un MapiMessage. Cuando los destinatarios del correo electrónico hacen clic en el adjunto de referencia, podrán acceder al archivo vinculado si tienen los permisos apropiados para hacerlo. Al usar un adjunto de referencia, puedes enviar un mensaje de correo electrónico más pequeño y asegurarte de que todos tengan acceso a la versión más actualizada del archivo o elemento.

El método tiene los siguientes parámetros:

  • name - el nombre del adjunto
  • sharedLink - un enlace compartido completamente calificado al adjunto proporcionado por el servicio web que manipula el adjunto
  • url - una ubicación de archivo
  • providerName - un nombre del proveedor del adjunto de referencia

El siguiente ejemplo de código demuestra cómo agregar un adjunto de referencia a un mensaje:

// Supongamos que deseas enviar un mensaje de correo electrónico que incluya un enlace a un archivo Document.pdf almacenado en Google Drive.
// En lugar de adjuntar directamente el documento al mensaje de correo electrónico,
// puedes crear un adjunto de referencia que vincule al archivo en Google Drive.

// Crear un mensaje
var msg = new MapiMessage("from@domain.com", "to@domain.com", "Archivo de mensaje de Outlook",
    "Este mensaje ha sido creado por Aspose.Email", OutlookMessageFormat.Unicode);

// Agregar adjunto de referencia
msg.Attachments.Add("Document.pdf",
    "https://drive.google.com/file/d/1HJ-M3F2qq1oRrTZ2GZhUdErJNy2CT3DF/",
    "https://drive.google.com/drive/my-drive",
    "GoogleDrive");
//Además, puedes establecer propiedades adicionales del adjunto
msg.Attachments[0].SetProperty(KnownPropertyList.AttachmentPermissionType, AttachmentPermissionType.AnyoneCanEdit);
msg.Attachments[0].SetProperty(KnownPropertyList.AttachmentOriginalPermissionType, 0);
msg.Attachments[0].SetProperty(KnownPropertyList.AttachmentIsFolder, false);
msg.Attachments[0].SetProperty(KnownPropertyList.AttachmentProviderEndpointUrl, "");
msg.Attachments[0].SetProperty(KnownPropertyList.AttachmentPreviewUrl, "");
msg.Attachments[0].SetProperty(KnownPropertyList.AttachmentThumbnailUrl, "");
// Finalmente guarda el mensaje
msg.Save(@"my.msg");

Incrustando un Mensaje como Adjunto

El siguiente fragmento de código te muestra cómo incrustar un archivo MSG como adjunto a un mensaje.

Leyendo Mensajes Incrustados desde Adjuntos

El siguiente fragmento de código te muestra cómo leer mensajes incrustados desde adjuntos.

Inserción y Reemplazo de Adjuntos

La API de Aspose.Email proporciona la capacidad de insertar adjuntos en un índice específico en el mensaje principal. También proporciona la facilidad de reemplazar el contenido de un adjunto con otro adjunto de mensaje.

Insertar en una Ubicación Específica

La API de Aspose.Email proporciona la capacidad de insertar un adjunto MSG en un MSG principal usando el método Insert de MapiAttachmentCollection MapiAttachmentCollection Insert(int index, string name, MapiMessage msg). El siguiente fragmento de código te muestra cómo insertar un adjunto en una ubicación específica.

Reemplazar Contenidos del Adjunto

Esto se puede usar para reemplazar el contenido de un adjunto incrustado con los nuevos usando el método Replace. Sin embargo, no se puede usar para insertar un adjunto con PR_ATTACH_NUM = 4 (por ejemplo) en la colección con collection.Count = 2. El siguiente fragmento de código te muestra cómo reemplazar los contenidos de un adjunto.

Renombrar un Adjunto en MapiMessage

Es posible editar el valor de la propiedad DisplayName en los adjuntos de MapiMessage.

var msg = MapiMessage.Load(fileName);
msg.Attachments[0].DisplayName = "Nuevo nombre para mostrar 1";
msg.Attachments[1].DisplayName = "Nuevo nombre para mostrar 2";

Guardar Adjuntos desde Mensajes Firmados Digitalmente

La API de Aspose.Email proporciona la capacidad de obtener o establecer un valor que indique si un mensaje firmado en claro será decodificado.

Trabajando con propiedades MAPI Trabajando con Contactos de Outlook