چگونه با Aspose.Email FOSS برای .NET شروع کنیم
این راهنما شما را در نصب کتابخانه، خواندن اولین فایل MSG، ایجاد یک پیام از ابتدا و تبدیل بین فرمتهای EML و MSG راهنمایی میکند.
مرحله 1 — نصب بسته
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($"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() فایل MSG را تجزیه میکند، کانتینر CFB آن را پردازش مینماید و تمام ویژگیهای MAPI را از طریق ویژگیهای C# با نوع قوی در دسترس قرار میدهد. نیازی به Microsoft Outlook نیست.
مرحله ۳ — ایجاد یک فایل 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[] دریافت کنید.
مرحله ۴ — تبدیل 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#
- FAQ — پاسخ به سؤالات رایج
- راهنمای نصب — راهاندازی NuGet و الزامات نسخه .NET