كيفية البدء مع Aspose.Email FOSS لـ .NET
هذا الدليل يرافقك خطوة بخطوة في تثبيت المكتبة، قراءة ملف MSG الأول الخاص بك، إنشاء رسالة من الصفر، وتحويل بين صيغتي EML و MSG.
الخطوة 1 — تثبيت الحزمة
dotnet add package Aspose.Email.Fossلا يلزم أي تكوين إضافي. الحزمة لا تحتوي على تبعيات أصلية.
الخطوة 2 — قراءة ملف MSG
أنشئ تطبيق وحدة تحكم وأضف الشيفرة التالية:
using System.IO;
using Aspose.Email.Foss.Msg;
using var stream = File.OpenRead("sample.msg");
var message = MapiMessage.FromStream(stream);
Console.WriteLine($"Subject: {message.Subject}");
Console.WriteLine($"From: {message.SenderEmailAddress}");
Console.WriteLine($"Body: {message.Body}");
foreach (var recipient in message.Recipients)
Console.WriteLine($"To: {recipient.EmailAddress}");
foreach (var attachment in message.Attachments)
Console.WriteLine($"Attachment: {attachment.Filename} ({attachment.MimeType})");MapiMessage.FromStream() يحلل حاوية CFB لملف MSG ويعرض جميع خصائص MAPI من خلال خصائص C# ذات النوع القوي. لا يلزم وجود Microsoft Outlook.
الخطوة 3 — إنشاء ملف MSG جديد
using System.IO;
using Aspose.Email.Foss.Msg;
var message = MapiMessage.Create("Meeting Notes", "Please find the notes attached.");
message.SenderName = "Alice";
message.SenderEmailAddress = "alice@example.com";
message.AddRecipient("bob@example.com", "Bob");
// Add a file attachment
message.AddAttachment("notes.txt", System.Text.Encoding.UTF8.GetBytes("Meeting notes here"), "text/plain");
// Save to file
message.Save("meeting_notes.msg");
Console.WriteLine("Created meeting_notes.msg");MapiMessage.Create() ينتج رسالة في الذاكرة. Save() يسلسلها إلى تنسيق MSG — يمكنك تمرير مسار ملف، أو Stream، أو استدعاء Save() بدون أي معاملات للحصول على byte[].
الخطوة 4 — تحويل EML إلى MSG
using System.IO;
using Aspose.Email.Foss.Msg;
// Load from EML
using var input = File.OpenRead("message.eml");
var message = MapiMessage.LoadFromEml(input);
Console.WriteLine($"Subject: {message.Subject}");
// Save as MSG
message.Save("converted.msg");
Console.WriteLine("Saved converted.msg");
// Or save back to EML (round-trip)
message.SaveToEml("roundtrip.eml");يحافظ محلل MIME المدمج على الموضوع والنص والنص HTML والمرسل والمستلمين وجميع المرفقات خلال عمليات التحويل الكاملة بين EML ↔ MSG.
الخطوات التالية
- الميزات والوظائف — مرجع كامل للميزات مع أمثلة C#
- الأسئلة المتكررة — إجابات على الأسئلة الشائعة
- دليل التثبيت — إعداد NuGet ومتطلبات إصدارات .NET