الأسئلة المتكررة — Aspose.Email FOSS for .NET

الترخيص

ما الترخيص الذي يستخدمه Aspose.Email.Foss؟

رخصة MIT. لا يلزم مفتاح ترخيص. استخدم بحرية في المشاريع الشخصية والتجارية ومفتوحة المصدر.

التثبيت

كيف أقوم بتثبيت Aspose.Email.Foss؟

dotnet add package Aspose.Email.Foss

ما هو إصدار .NET المطلوب؟

.NET 8.0 أو أحدث. المكتبة لا تدعم .NET Framework أو .NET Standard.

هل هناك تبعيات أصلية؟

لا. المكتبة مكتوبة بالكامل بلغة C# المدارة ولا تعتمد على مكونات أصلية. تعمل بنفس الطريقة على Windows, Linux, macOS, Docker, وبيئات بدون خادم.

دعم الصيغ

ما هي صيغ البريد الإلكتروني المدعومة؟

هل يمكنني قراءة ملفات EML؟

نعم. استخدم MapiMessage.LoadFromEml(stream) لتحميل ملف .eml قياسي إلى MapiMessage. يتعامل محلل MIME المدمج مع رؤوس مطوية، محتوى base64، و رسائل multipart.

هل يمكنني تحويل MSG إلى EML؟

نعم. استدعِ message.SaveToEml() للحصول على إخراج byte[] في الذاكرة، أو message.SaveToEml(stream) للكتابة إلى ملف. الموضوع، النص، نص HTML، المرسل، المستلمين، وجميع المرفقات محفوظة.

هل يتم دعم TNEF (winmail.dat)؟

لا. يتم دعم صيغ MSG (CFB) و EML (MIME) القياسية فقط.

هل يتم دعم IMAP/SMTP/POP3؟

لا. تتعامل المكتبة مع ملفات MSG مباشرة ولا تشمل أي طبقة شبكة/بروتوكول.

استخدام API

كيف أحمل ملف MSG؟

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

كيف أنشئ رسالة جديدة؟

var message = MapiMessage.Create("Subject", "Body");
message.SenderEmailAddress = "alice@example.com";
message.AddRecipient("bob@example.com", "Bob");
message.Save("output.msg");

كيف أضيف المرفقات؟

// From byte array
message.AddAttachment("file.pdf", pdfBytes, "application/pdf");

// From stream
using var stream = File.OpenRead("photo.png");
message.AddAttachment("photo.png", stream, "image/png");

كيف يمكنني تحويل EML إلى MSG؟

using var eml = File.OpenRead("message.eml");
var message = MapiMessage.LoadFromEml(eml);
message.Save("message.msg");

كيف يمكنني الوصول إلى بنية CFB الخام؟

using Aspose.Email.Foss.Cfb;
using var reader = CfbReader.FromFile("message.msg");
foreach (var entry in reader.IterChildren(CfbConstants.RootStreamId))
    Console.WriteLine(entry.Name);

القيود المعروفة

هل هناك أي طرق غير مُنفذة؟

لا توجد أي دوال تجريبية غير منفذة عمدًا في الإصدار الحالي.

هل يتوفر دعم التقويم/المواعيد؟

المكتبة تتعامل مع ملفات MSG بشكل عام. يمكن الوصول إلى الخصائص الخاصة بالتقويم عبر SetProperty() / GetPropertyValue() باستخدام معرفات خصائص MAPI من CommonMessagePropertyId، ولكن لا توجد واجهة برمجة تطبيقات مخصصة للتقويم أو المواعيد.

هل يتم ضمان سلامة الخيوط؟

كل مثال MapiMessage وCfbReader مستقل.
الوصول المتزامن إلى أمثلة منفصلة من خيوط منفصلة آمن.
لا تشارك مثالًا واحدًا عبر الخيوط دون مزامنة خارجية.