چگونه با Aspose.Email FOSS برای .NET شروع کنیم

چگونه با 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 حفظ می‌کند.


مراحل بعدی

 فارسی