مقدمة
Aspose.Email FOSS for .NET is a free, open-source C# library that lets you work with Outlook ملفات MSG، وملفات الملفات الثنائية (CFB) الحاويات، وإرسال رسائل EML مباشرة في .NET الخاص بك. التطبيق - لا Microsoft Outlook، لا COM التفاعل، ولا المكتبات الأصلية مطلوبة. يبدو وكأنه حزمة واحدة من NuGet ويعمل على نفس النحو على حاويات Windows و Linux و macOS و Docker ،, وظائف خالية من الخادم.
يحدد المكتبة مشكلة متكررة في الأعمال التجارية والعمل التكامل: Outlook .msg ملفات يتم إنتاجها من قبل الملايين من مستخدمي الأعمال ، ولكن إزالتها دون Outlook قد تم تاريخها مطلوب أوتوماتيك COM أو المكتبات التجارية باهظة الثمن. Aspose.الرسائل البريدية FOSS ل .NET يوفر الدعم الكامل للقراءة/الكتابة لـ MSG، والحاوية الثنائية CFB الأساسية، وتشكيل EML/MIME - جميع تحت رخصة MIT دون أي قيود على الاستخدام.
سواء كنت تبني خط أنابيب أرشيف البريد الإلكتروني ، أداة الهجرة ، مستخلص الملصقات ،, أو مولد MSG الآلي، هذه المكتبة تمنحك الوصول المباشر منخفض المستوى إلى كل بايت من إرسال رسالة خاصة إلى جانب مستوى عال MapiMessage API الذي يسمح لك بالبدء في دقائق.
الميزات الرئيسية
اقرأ المزيد Outlook MSG Files
فتح أي .msg الملف من مسار أو تدفق مع MsgReader.FromFile() أو MsgReader.FromStream(). الوصول إلى سياق ممتلكات MAPI الكامل، وسجلات المستلمين، ومرفقات التخزين الفرعي في مستوى البيوت عبر MsgStorage و MsgStream.
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 من Scratch
إنشاء رسالة بريد إلكتروني كاملة باستخدام البرمجيات MapiMessage.Create().إعداد الموضوع، النص المباشر الجسم، جسم HTML، اسم المرسل، عنوان البريد الإلكتروني المرسلة، وقت التسليم، و ID الرسالة على الإنترنت، ثم إضافة المستلمين مع AddRecipient() و المرفقات مع AddAttachment().- التفكير في سلسلة مع message.Save().
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 (والعودة)
تحميل معيار RFC 5322 .eml الملفات في A MapiMessage مع MapiMessage.LoadFromEml(), ثم حفظها كـ Outlook .msg الملف - أو عكس العملية مع MapiMessage.SaveToEml(). يحتفظ بطاقة MIME المدمجة بموضوع، والجسم، وجسم HTML، والرسالة، والمستلمين، والإرفاق. من خلال EML ↔ MSG الدائرة الكاملة.
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);
الحاوية CFB Access
يتم بناء ملفات Outlook MSG على تنسيق الملفات المركبة (CFB) - ثنائي الهرمي. حاوية مماثلة لنظام الملفات. CfbReader عرض شجرة الدليل الكاملة: تخزينات إيترات وتدفق مع IterStorages(), IterStreams(),و ، و IterChildren(),- الملاحة إلى محددة الدخول على الطريق مع ResolvePath(), وقراءة البيوت الخام التيار مع GetStreamData().
CfbWriter يتيح لك بناء وتسلسل وثيقة CFB من الخرطوم. CfbDocument, الالتزام CfbStorage و CfbStream الوسائل، وطلب CfbWriter.ToBytes() أو CfbWriter.WriteFile() من أجل التسلسل.
MAPI الملكية والوصول إلى الارتباط
وَالْمُتَّقِينَ MapiPropertyCollection تتيح الفئة الوصول إلى ملكية MAPI المسمى لأي MSG أو التخزين الموضوع : الاستخدام Get(), Set(), Add(),و ، و Remove() مع المعيار CommonMessagePropertyId أو PropertyTypeCode الوصول إلى الميثاد البيانات وبيانات الثنائية من خلال MapiAttachment الممتلكات : Filename, MimeType, ContentId,و ، و Data.
بدء سريع
قم بتثبيت الحزمة :
dotnet add package Aspose.Email.FOSSاقرأ موضوع من ملف MSG:
using System.IO;
using Aspose.Email.Foss.Msg;
using var stream = File.OpenRead("sample.msg");
var message = MapiMessage.FromStream(stream);
Console.WriteLine(message.Subject);
Console.WriteLine(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})");
تنسيقات مدعومة
| شكل | التمديد | قراءة | كتب |
|---|---|---|---|
| ملف ثنائي الملفات | .cfb | ✓ | ✓ |
| Outlook رسالة | .msg | ✓ | ✓ |
| MIME / EML | .eml | ✓ | ✓ |
المصدر المفتوح و الترخيص
Aspose.Email FOSS for .NET is released under the مجوز MIT.يمكنك استخدامها بحرية في المشاريع الشخصية والتجارية والمفتوحة المصدر مع لا قيود على الاستخدام. متوفرة في github.com/aspose-email-foss/Aspose.email-FOSS-for-.Net.