Primeros pasos

Comenzando con Aspose.Email FOSS para .NET

Bienvenido a Aspose.Email FOSS for .NET, una biblioteca C# gratuita, con licencia MIT, para leer, crear y escribir archivos Outlook MSG, contenedores Compound File Binary (CFB) y mensajes EML. Esta guía lo lleva desde un proyecto .NET nuevo hasta trabajar con archivos MSG en minutos.


Requisitos previos

RequisitoDetalle
.NET8.0 o posterior
Administrador de paquetesNuGet (dotnet CLI o Visual Studio)
SOWindows, macOS o Linux
DependenciasNinguna — C# puro administrado

Instalación

Instalar desde NuGet:

dotnet add package Aspose.Email.Foss

Verifique en una aplicación de consola mínima:

using Aspose.Email.Foss.Msg;

var message = MapiMessage.Create("Test", "Hello");
Console.WriteLine($"Subject: {message.Subject}");
// Output: Subject: Test

Consulte la Guía de instalación para obtener detalles de la configuración del proyecto.


Qué puedes hacer

Una vez instalado, puedes inmediatamente:

  • Leer archivos MSG con MapiMessage.FromStream() o MapiMessage.FromFile() — acceder al asunto, cuerpo, cuerpo HTML, remitente, destinatarios y archivos adjuntos
  • Crear mensajes MSG desde cero con MapiMessage.Create() — establecer todos los campos, añadir destinatarios y archivos adjuntos, y luego serializar con message.Save()
  • Convertir entre MSG y EML (MIME/RFC 5322) con LoadFromEml() y SaveToEml()
  • Inspeccionar el contenedor binario CFB subyacente con CfbReader — recorrer almacenes y flujos, resolver rutas, leer bytes sin procesar
  • Escribir documentos CFB con CfbWriter para inspección forense o construcción de formatos
  • Manejar archivos adjuntos — añadir archivo, flujo o adjuntos MSG incrustados con metadatos completos

Inicio rápido

Leer un archivo MSG y imprimir su asunto y destinatarios:

using System.IO;
using Aspose.Email.Foss.Msg;

using var stream = File.OpenRead("sample.msg");
var message = MapiMessage.FromStream(stream);

Console.WriteLine($"Subject: {message.Subject}");
Console.WriteLine($"From: {message.SenderEmailAddress}");

foreach (var recipient in message.Recipients)
    Console.WriteLine($"To: {recipient.EmailAddress}");

foreach (var attachment in message.Attachments)
    Console.WriteLine($"Attachment: {attachment.Filename} ({attachment.MimeType})");

Próximos pasos

 Español