1. Produkty
  2.   Aspose.Email
  3.   Aspose.Email FOSS for .NET

Aspose.Email FOSS for .NET

Čtěte, vytvářejte a zpracovávejte soubory Outlook MSG, kontejnery CFB a zprávy EML z .NET — zdarma a open‑source, bez závislosti na Microsoft Outlook.

Aspose.Email FOSS for .NET Aspose.Email FOSS
for .NET

Dokumentace GitHub

Open-Source .NET knihovna pro soubory MSG, CFB a EML

FOSS pro .NET je bezpodmínečná knihovna C#, která pracuje s soubory Microsoft Outlook .msg , kontejnery Compound File Binary (CFB) a zprávami EML. Přidejte jediný balíček NuGet a okamžitě začněte číst, vytvářet a procesovat e-mailové zprávy bez instalace programu Microsoft Outlook nebo jakéhokoli vlastnického runtimeu.

Knihovna poskytuje dvě úrovně přístupu. Na nízké úrovni, CfbReader a CfbWriter dát plnou kontrolu nad CFB binární kontejnery průřezné adresářové položky, číst a psát ukládání uzlů a dat proudu, a zkontrolovat syrový sektor rozložení. MsgReader A MsgWriter zvládnout MSG formátu na vrcholu CFb , odhalování MAPI majetku proudů, přijímací tabulky a přílohy pod-skladovny . Na vysoké úrovni , MapiMessage umožňuje vytvořit nové zprávy ze středu, přečíst , tělo , vysílač a příjemci , spravovat přidávání, konverzovat mezi MSL a formát EMIME prostřednictvím vestavěné implementace MIME .

Knihovna je zaměřena na .NET 8.0 nebo novější a nemá žádné nativní závislosti, což ji činí vhodnou pro Windows, Linux, macOS, Docker kontejnery a bezserverové funkce. Pro další vlastnosti a komerční podporu viz Aspose.Email for .NET.

CFB kontejner čtení a psaní

  • Otevřete soubory CFB: Nabíjejte stávající kontejnery CF B z cesty, proudu nebo bajtového řetězce souborů prostřednictvím CfbReader.FromFile(), CfbReader.FromStream() nebo new CfbReader(data).
  • Přeskočte strom adresáře: Iterujte úložiště, toky a děti pomocí IterStorages(), IterStreams() , IterChildren() a IterTree().
  • ** Vyřešit cesty:** Navádět v hierarchii ukládání s ResolvePath(names) najít konkrétní tok podle řetězce jmen.
  • ** Napsat CFB kontejnery:** Programaticky vytvořit dokumenty CF B s CfbDocument a serializovat do bajtů nebo souboru prostřednictvím CfbWriter.ToBytes() nebo CfbWriter.WriteFile().
  • ** Přidání úložišť a toků:** Před sérializací připojte uzly CfbStorage a CfbStream k jakémukoli uzlu pro ukládání.

Kde se používá přístup CFB

  • ** Inspekce souborů MSG:** CFB je formát kontejneru pro Outlook .msg soubory přímý přístup k CF B umožňuje forenzní inspekci a opravu.
  • ** Obvyklé binární formáty:** Jakákoli starší aplikace, která používá CFB pro ukládání dat, může být čtená nebo zapsána bez závislosti na COM.
  • ** Obnova dat:** Projít plným stromem adresářů a extrahovat surové byty toku z poškozených nebo nestandardních souborů CFB.
  • Binární testování po cestě: Sérializace dokumentu do bajtů a jeho přeložení k ověření beztrátové serializace v automatizovaných testech.

MSG soubor Číst a psát

  • Přečti MSG soubory: Otevři Outlook MS G soubory s MsgReader.FromFile() nebo MsgReader.FromStream() a přístup k základním MAPI vlastností toků, příjemců záznamů a přílohy pod-stávky.
  • Píše MSG soubory: Vytváříte MS G soubory z MsgDocument s MsgWriter.ToBytes() nebo MsgWriter.WriteFile().
  • Přístup MAPI nízké úrovně: Číst toky vlastností nejvyššího stupně, pojmenované vlastnosti a údaje o připojených položkách prostřednictvím MsgStorage, MsgStream a MsgStorage.FindStream().
  • ** Navigace pro ukládání MSG:** Pro vyhledávání jmenovaných podpísmenek použijte MsgStorage.FindStream() a MsgStorage.FindStorage().

Kde se používá zpracování MSG

  • E-mailové archivní potrubí: Bulk-read .msg soubory z adresářů archivace a extrahovat metadata nebo přílohy.
  • ** Nástroje pro migraci:** Konverze sbírek MSG do standardních formátů pro import do systémů jiných než Outlook.
  • ** Právní zjištění:** Parse raw MAPI vlastností toky pro získání všech polí sdělení včetně nestandardních vlastostí.
  • Automatické doručování zpráv: Programově vytvářet soubory .msg a dodávat je do poštovních systémů založených na Outlooku.

API pro sdělení na vysoké úrovni

  • Vytvořte zprávy: Vytváříme kompletní e-mail s MapiMessage.Create(subject, body), nastaveními SenderName, SenderEmailAddress a HtmlBody.
  • ** Přidat příjemce:** Připojit To, Cc a Bcc příjmů prostřednictvím AddRecipient() s e-mailovou adresou a zobrazovací jméno.
  • ** Správa příloh:** Přidávání souborů a přenosových příkladů pomocí AddAttachment() nebo vytváření objektů MapiAttachment přímo pomocím Filename, MimeType , ContentId a Data.
  • Uchování a přeložení: Sérializace pomocí message.Save() nebo message.Save(stream) a opětovné naložení pomocím MapiMessage.FromFile() či MapiMessage.FromStream().

Kde se používá API na vysoké úrovni

  • Automatické generování e‑mailů: Vytvořte tisíce personalizovaných souborů MSG z datových záznamů ve dávkových úlohách.
  • Vytváření testovacích fixů: Sestavte známé dobré soubory MSG s předvídatelným obsahem pro integrační testovací sady.
  • Extrahování příloh: Načtěte soubor MSG, iterujte message.Attachments a uložte každou attachment.Data na disk.
  • Inspekce vlastností: Přistupujte k message.Subject, message.Body, message.SenderEmailAddress a message.Recipients bez COM automatizace.

Konverze EML a MIME

  • Load EML into MapiMessage: Parse standardní .eml soubor (RFC 5322 / MIME) do plného MapiMessage objektu prostřednictvím MapiMessage.LoadFromEml(stream).
  • Uchráníte MapiMessage jako EML: Sérializace MapiMessage zpět do formátu MIME pomocí message.SaveToEml() nebo message.SaveToEml(stream).
  • Vrátitá věrnost: Předmět, tělo, HTML-tělo, odesílač, příjemce a přílohy jsou všechny uchovávány prostřednictvím EML → MSG → EM L round-trips.
  • ** Žádný externí MIME parser:** EML parsing je implementován v rámci knihovny není nutná závislost na systému System.Net.Mail.

Kde se používá konverze EML

  • Přepravu formátu: Přijímají e-maily jako EML z poštovních serverů a konvertují do MSG pro Outlook kompatibilní ukládání.
  • Soulad se standardy: Konvertuje proprietární soubory MSG na standardní MIME pro doručení do jakékoli poštovní dopravy.
  • Archivní normalizace: Normalizovat smíšený archiv souborů .eml a .msg do jednoho formátu.
  • Pracovní postupy testování: Vytvořte při zkouškách zařízení .eml a ověřte, zda přežijí cestu MSG bez ztráty dat.

Číst předmět z souboru MSG

Otevřete soubor Outlook MSG ze streamu a vytiskněte předmět není nutný Microsoft Outlook.

using System.IO;
using Aspose.Email.Foss.Msg;
using var stream = File.OpenRead("sample.msg");
var message = MapiMessage.FromStream(stream);
Console.WriteLine(message.Subject);

Vytvořit a uložit zprávu MSG

Vytvořte kompletní e-mail se odesílatelem, příjemcem a přílohou a napište ho do souboru MSG.

using System.IO;
using Aspose.Email.Foss.Msg;
var message = MapiMessage.Create("Hello", "Body");
message.SenderName = "Alice";
message.SenderEmailAddress = "alice@example.com";
message.AddRecipient("bob@example.com", "Bob");
using var attachmentStream = new MemoryStream("abc"u8.ToArray());
message.AddAttachment("note.txt", attachmentStream, "text/plain");
using var output = File.Create("hello.msg");
message.Save(output);

Konverze EML na MSG

Nahrát standardní soubor .eml a uložit jej jako Outlook .msg souboru pomocí vestavěného MIME analyzátoru.

using System.IO;
using Aspose.Email.Foss.Msg;
using var input = File.OpenRead("message.eml");
var message = MapiMessage.LoadFromEml(input);
using var msgOutput = File.Create("message.msg");
message.Save(msgOutput);
using var emlOutput = File.Create("roundtrip.eml");
message.SaveToEml(emlOutput);
  

Podpora a vzdělávací materiály

 Čeština