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

Aspose.Email FOSS pre .NET

Čítajte, vytvárajte a spracovávajte Outlook MSG súbory, CFB kontajnery a EML správy z .NET — zadarmo a open-source, bez závislosti na Microsoft Outlook.

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

Documentation GitHub

Open-Source .NET knižnica pre MSG, CFB a EML súbory

Aspose.Email FOSS pre .NET je knižnica C# s licenciou MIT, bez závislostí, určená na prácu so súbormi Microsoft Outlook .msg, kontajnermi Compound File Binary (CFB) a správami EML. Pridajte jediný balík NuGet a okamžite začnite čítať, vytvárať a spracovávať e‑mailové správy bez inštalácie Microsoft Outlook alebo akéhokoľvek proprietárneho runtime.

Knižnica poskytuje dve úrovne prístupu. Na nízkej úrovni, CfbReader a CfbWriter poskytujú úplnú kontrolu nad binárnymi kontajnermi CFB — prechádzajte položky adresára, čítajte a zapisujte úložné uzly a dáta prúdu a kontrolujte surové usporiadanie sektorov. MsgReader a MsgWriter spracovávajú formát MSG nad CFB, odhaľujúc prúdy vlastností MAPI, tabuľky príjemcov a podúložiská príloh. Na vysokej úrovni, MapiMessage vám umožňuje vytvárať nové správy od začiatku, čítať predmet, telo, odosielateľa a príjemcov, spravovať prílohy a konvertovať medzi formátmi MSG a EML pomocou vstavaného MIME implementácie.

Knižnica ciele .NET 8.0 alebo novšiu a nemá natívne závislosti, čo ju robí vhodnou pre Windows, Linux, macOS, Docker kontajnery a serverless funkcie. Pre ďalšie funkcie a komerčnú podporu pozri Aspose.Email for .NET.

Čítanie a zápis CFB kontajnera

  • Open CFB files: Načítajte existujúce CFB kontajnery z cesty k súboru, streamu alebo poľa bajtov pomocou CfbReader.FromFile(), CfbReader.FromStream() alebo new CfbReader(data).
  • Prechádzajte stromom adresárov: Iterujte úložiská, prúdy a podriadené položky pomocou IterStorages(), IterStreams(), IterChildren() a IterTree().
  • Riešiť cesty: Navigujte v hierarchiách vnorených úložísk pomocou ResolvePath(names) a nájdite konkrétny prúd podľa reťazca názvov.
  • Zapisovať CFB kontajnery: Vytvárajte CFB dokumenty programovo pomocou CfbDocument a serializujte ich do bajtov alebo súboru pomocou CfbWriter.ToBytes() alebo CfbWriter.WriteFile().
  • Pridať úložiská a prúdy: Pripojte uzly CfbStorage a CfbStream k akémukoľvek uzlu úložiska pred serializáciou.

Kde sa používa prístup CFB

  • Kontrola súborov MSG: CFB je kontajnerový formát pre súbory Outlook .msg — priame prístup k CFB umožňuje forenznú kontrolu a opravu.
  • Vlastné binárne formáty: Akákoľvek staršia aplikácia používajúca CFB na ukladanie dát môže byť čítaná alebo zapisovaná bez závislosti na COM.
  • Obnova dát: Prejdite celý strom adresárov a extrahujte surové bajty prúdu z poškodených alebo neštandardných CFB súborov.
  • Binary round-trip testing: Serializujte dokument do bajtov a znovu ho načítajte, aby ste v automatizovaných testoch overili bezstratovú serializáciu.

Čítanie a zápis MSG súboru

  • Čítať súbory MSG: Otvorte súbory Outlook MSG pomocou MsgReader.FromFile() alebo MsgReader.FromStream() a získajte prístup k podkladovým MAPI property streams, recipient records a attachment sub-storages.
  • Zapíšte MSG súbory: Vytvorte MSG súbory z MsgDocument pomocou MsgWriter.ToBytes() alebo MsgWriter.WriteFile().
  • Nízkoúrovňový prístup k MAPI: Čítajte prúdy vlastností najvyššej úrovne, pomenované vlastnosti a údaje príloh prostredníctvom MsgStorage, MsgStream a MsgStorage.FindStream().
  • Navigácia úložiska MSG: Použite MsgStorage.FindStream() a MsgStorage.FindStorage() na vyhľadanie pomenovaných podzáznamov.

Kde sa používa spracovanie MSG

  • Email archival pipelines: Hromadné čítanie .msg súborov z archívnych adresárov a extrahovanie metadát alebo príloh.
  • Nástroje na migráciu: Konvertovať kolekcie MSG do štandardných formátov pre import do systémov, ktoré nie sú Outlook.
  • Právne objavovanie: Analyzovať surové prúdy vlastností MAPI na extrahovanie všetkých polí správ vrátane neštandardných vlastností.
  • Automatické doručovanie správ: Programovo vytvárať súbory .msg a doručovať ich do poštových systémov založených na Outlooku.

API pre vysokú úroveň správ

  • Vytvorte správy: Zostavte kompletný e‑mail s MapiMessage.Create(subject, body), nastavte SenderName, SenderEmailAddress a HtmlBody.
  • Pridať príjemcov: Pripojte To, Cc a Bcc príjemcov prostredníctvom AddRecipient() s e‑mailovou adresou a zobrazovaným menom.
  • Spravovať prílohy: Pridajte súborové a streamové prílohy pomocou AddAttachment() alebo konštruujte objekty MapiAttachment priamo pomocou Filename, MimeType, ContentId a Data.
  • Uložiť a načítať: Serializovať pomocou message.Save() alebo message.Save(stream) a načítať pomocou MapiMessage.FromFile() alebo MapiMessage.FromStream().

Kde sa používa API vyššej úrovne

  • Automatizovaná tvorba e‑mailov: Vytvorte tisíce personalizovaných súborov MSG z dátových záznamov v dávkových úlohách.
  • Vytvorenie testovej fixúry: Vytvorte známe dobré MSG súbory s predvídateľným obsahom pre integračné testovacie sady.
  • Extrahovanie príloh: Načítajte súbor MSG, prejdite message.Attachments a uložte každú attachment.Data na disk.
  • Kontrola vlastnosti: Prístup k message.Subject, message.Body, message.SenderEmailAddress a message.Recipients bez COM automatizácie.

Konverzia EML a MIME

  • Load EML into MapiMessage: Rozparsovať štandardný .eml súbor (RFC 5322 / MIME) do úplného MapiMessage objektu prostredníctvom MapiMessage.LoadFromEml(stream).
  • Uložiť MapiMessage ako EML: Serializovať MapiMessage späť do formátu MIME s message.SaveToEml() alebo message.SaveToEml(stream).
  • Round-trip fidelity: Predmet, telo, HTML telo, odosielateľ, príjemcovia a prílohy sú všetky zachované počas prechodu EML → MSG → EML.
  • Žiadny externý MIME parser: Spracovanie EML je implementované natívne v knižnici — nie je potrebná závislosť na System.Net.Mail.

Kde sa používa konverzia EML

  • Prepojenie formátov: Prijímajte e‑mailové správy vo formáte EML od poštových serverov a konvertujte ich do MSG pre úložisko kompatibilné s Outlookom.
  • Dodržiavanie štandardov: Konvertovať proprietárne súbory MSG na štandardný MIME pre doručenie do akéhokoľvek poštového transportu.
  • Archiválna normalizácia: Normalizovať zmiešaný archív súborov .eml a .msg na jeden formát.
  • Testovacie pracovné postupy: Vygenerujte .eml fixúry v testoch a overte, že prežijú MSG round‑trip bez straty dát.

Prečítajte predmet z MSG súboru

Otvorte súbor Outlook MSG zo streamu a vytlačte predmet — nie je potrebný 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);

Vytvorte a uložte správu MSG

Vytvorte kompletný e‑mail s odosielateľom, príjemcom a prílohou, potom ho zapíšte do súboru 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);

Previesť EML na MSG

Načítajte štandardný .eml súbor a uložte ho ako Outlook .msg súbor pomocou vstavaného MIME parsera.

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);
  

Support and Learning Resources

 Slovenčina