1. محصولات
  2.   Aspose.Email
  3.   Aspose.Email FOSS for .NET

Aspose.Email FOSS for .NET

فایل‌های Outlook MSG، کانتینرهای CFB و پیام‌های EML را از .NET بخوانید، ایجاد کنید و پردازش کنید — رایگان و متن باز، بدون وابستگی به Microsoft Outlook.

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

مستندات GitHub

کتابخانه .NET منبع باز برای فایل های MSG، CFB و EML

Aspose.Email FOSS برای .NET یک کتابخانه C# با مجوز MIT، بدون وابستگی برای کار با فایل‌های Microsoft Outlook .msg، کانتینرهای Compound File Binary (CFB) و پیام‌های EML است. یک بسته NuGet اضافه کنید و بلافاصله شروع به خواندن، ایجاد و پردازش پیام‌های ایمیل کنید بدون اینکه Microsoft Outlook یا هر زمان‌اجرای مالکیتی نصب کنید.

کتابخانه دو سطح دسترسی ارائه می‌دهد. در سطح پایین، CfbReader و CfbWriter کنترل کامل بر کانتینرهای باینری CFB را فراهم می‌کنند — مرور ورودی‌های دایرکتوری، خواندن و نوشتن گره‌های ذخیره‌سازی و داده‌های جریان، و بررسی چیدمان خام سکتورها. MsgReader و MsgWriter فرمت MSG را بر روی CFB مدیریت می‌کنند و جریان‌های ویژگی MAPI، جداول دریافت‌کنندگان و زیرذخیره‌سازی‌های پیوست را در دسترس می‌گذارند. در سطح بالا، MapiMessage به شما امکان می‌دهد پیام‌های جدید را از ابتدا ایجاد کنید، موضوع، بدنه، فرستنده و دریافت‌کنندگان را بخوانید، پیوست‌ها را مدیریت کنید و بین فرمت‌های MSG و EML از طریق پیاده‌سازی داخلی MIME تبدیل کنید.

کتابخانه هدف .NET 8.0 یا بالاتر است و هیچ وابستگی بومی ندارد، بنابراین برای Windows، Linux، macOS، کانتینرهای Docker و توابع بدون سرور مناسب است. برای ویژگی‌های اضافی و پشتیبانی تجاری، به Aspose.Email for .NET مراجعه کنید.

CFB Container خواندن و نوشتن

  • Open CFB files: بارگذاری کانتینرهای CFB موجود از مسیر فایل، جریان یا آرایه بایت با استفاده از CfbReader.FromFile()، CfbReader.FromStream() یا new CfbReader(data).
  • Traverse the directory tree: تکرار ذخیره‌سازی‌ها، جریان‌ها و فرزندان با استفاده از IterStorages()، IterStreams()، IterChildren() و IterTree().
  • Resolve paths: پیمایش سلسله‌مراتب ذخیره‌سازی تو در تو با ResolvePath(names) برای یافتن یک جریان خاص بر اساس زنجیره نام.
  • Write CFB containers: ساخت اسناد CFB به‌صورت برنامه‌نویسی با CfbDocument و سریال‌سازی به بایت‌ها یا فایل از طریق CfbWriter.ToBytes() یا CfbWriter.WriteFile().
  • Add storages and streams: پیوست کردن گره‌های CfbStorage و CfbStream به هر گره ذخیره‌سازی قبل از سریال‌سازی.

جایی که از CFB Access استفاده می شود.

  • ** بازرسی فایل MSG:** CFB فرمت کانتینر برای Outlook .msg است. دسترسی مستقیم به CF B امکان بازرس و تعمیرات قانونی را فراهم می کند.
  • ** فرمت های باینری سفارشی:** هر برنامه قدیمی که از CFB برای ذخیره سازی داده استفاده می کند، بدون وابستگی COM خوانده یا نوشته می شود.
  • بازیافت داده: از درخت دایرکتوری کامل عبور کنید و بایت های جریان خام را از فایل های CFB آسیب دیده یا غیر استاندارد استخراج کنید.
  • ** تست دوگانه سفر:** یک سند را به بایت ها سریالیز کنید و آن را بارگیری مجدد کنید تا سریال سازی بدون ضرر در آزمایشات خودکار تأیید شود.

فایل MSG خواندن و نوشتن

  • ** فایل های MSG را بخوانید:** پرونده های Outlook MS G را با MsgReader.FromFile() یا MsgReader.FromStream() باز کنید و به جریان ویژگی MAPI زیربنایی، سوابق گیرنده و ذخیره سازی فرعی ضمیمه دسترسی پیدا کنید.
  • ** فایل های MSG بنویسید:** از MsgDocument با MsgWriter.ToBytes() یا MsgWriter.WriteFile() فایل ها را تولید کنید.
  • ** دسترسی MAPI سطح پایین:** جریان های ویژگی سطح بالا، خواص نامگذاری شده و داده های ضمیمه را از طریق MsgStorage ، MsgStream و MsgStorage.FindStream() بخوانید.
  • ** ناوبری ذخیره سازی MSG:** برای یافتن زیرنویس های نامگذاری شده از MsgStorage.FindStream() و MsgStorage.FindStorage() استفاده کنید.

جایی که از پردازش MSG استفاده می شود

  • نابرها ارشیو ایمیل: فایل های .msg با خواندن انبوه از دایرکتوری آرشیف و استخراج متاداتا یا ضمیمه ها.
  • ** ابزار مهاجرت:** مجموعه های MSG را به فرمتهای استاندارد برای وارد کردن در سیستم های غیر Outlook تبدیل کنید.
  • ** کشف قانونی:** جریان های دارایی MAPI خام را تجزیه و تحلیل کنید تا تمام زمینه های پیام از جمله خواص غیر استاندارد را استخراج کنید.
  • ** ارسال گزارش خودکار:** فایل های .msg را به صورت برنامه ای بسازید و آنها را در سیستم های ایمیل مبتنی بر Outlook تحویل دهید.

API پیام سطح بالا

  • ** پیام ایجاد کنید:** یک ایمیل کامل با MapiMessage.Create(subject, body) بسازید، تنظیمات SenderName ، SenderEmailAddress و HtmlBody. را انتخاب کنید.
  • ** دریافت کنندگان اضافه کنید:** To، Cc و Bcc را از طریق AddRecipient() با آدرس ایمیل و نام نمایش متصل کنید.
  • مدیریت ضمیمه ها: اضافه کردن فایل و جریان ضمیمات با AddAttachment() یا ساخت اشیاء MapiAttachment مستقیماً با استفاده از Filename، MimeType ، ContentId و Data.
  • ** ذخیره و بارگیری مجدد:** با message.Save() یا message.Save(stream) سریالیزه کنید و باMapiMessage.FromFile() و MapiMessage.FromStream() بارگذاری مجدد کنید.

جایی که از API سطح بالا استفاده می شود

  • ** تولید خودکار ایمیل:** هزاران فایل MSG شخصی از سوابق داده در کارهای دسته ای ایجاد کنید.
  • ** ایجاد دستگاه تست:** ساخت فایل های MSG شناخته شده با محتوای قابل پیش بینی برای مجموعه آزمایش ادغام.
  • ** استخراج ضمیمه:** یک فایل MSG را بارگیری کنید، message.Attachments را تکرار کنید و هر attachment.Data را به دیسک ذخیره کنید.
  • ** بازرسی املاک:** دسترسی به message.Subject، message.Body, message.SenderEmailAddress و message.Recipients بدون اتوماسیون COM.

تبدیل EML و MIME

  • ** EML را به MapiMessage بارگذاری کنید:** یک فایل استاندارد .eml (RFC 5322 / MIME) را با استفاده از MapiMessage.LoadFromEml(stream) در یک شیء کامل MapiMessage تجزیه و تحلیل کنید.
  • MapiMessage را به عنوان EML ذخیره کنید: یک MapiMessage را با message.SaveToEml() یا message.SaveToEml(stream) دوباره به قالب MIME سریال سازی کنید.
  • ** وفاداری سفر دور:** موضوع، بدن، HTML جسم، فرستنده، گیرندگان و ضمیمه ها همه از طریق EML → MSG → EM L سفر های دور حفظ می شوند.
  • ** هیچ تجزیه کننده خارجی MIME:** تجزیه EML در کتابخانه به طور بومی اجرا می شود نیازی به وابستگی System.Net.Mail نیست.

جایی که از تبدیل EML استفاده می شود

  • برج کردن فرمت: دریافت ایمیل به عنوان EML از سرورهای پست و تبدیل آن ها به MSG برای ذخیره سازی سازگار با Outlook.
  • امتثال با استانداردها: تبدیل فایل های اختصاصی MSG به MIME استاندارد برای تحویل به هر حمل و نقل پست.
  • تعدیل آرشیو: یک آرشوی مخلوط از فایل های .eml و .msg را به یک فرمت واحد تعدیلی کنید.
  • ** جریان های کاری تست:** تولید لوازم .eml در آزمایش ها و تأیید آنها از سفر MSG بدون از دست دادن داده زنده می مانند.

موضوعی را از فایل MSG بخوانید.

یک فایل MSG Outlook را از یک جریان باز کنید و موضوع 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);

ایجاد و ذخیره کردن پیام MSG

یک ایمیل کامل با فرستنده، گیرنده و ضمیمه بسازید سپس آن را به فایل 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);

تبدیل EML به MSG

یک فایل استاندارد .eml را بارگیری کنید و آن را به عنوان Outlook .msg با استفاده از تجزیه کننده MIME داخلی ذخیره کنید.

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

منابع پشتیبانی و آموزش

 فارسی