كيفية البدء مع Aspose.Email FOSS لـ .NET

كيفية البدء مع 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.


الخطوات التالية

 العربية