شروع کار

شروع کار با Aspose.Email FOSS برای .NET

به Aspose.Email FOSS for .NET خوش آمدید، یک کتابخانهٔ رایگان C# با مجوز MIT برای خواندن، ایجاد و نوشتن فایل‌های Outlook MSG، کانتینرهای Compound File Binary (CFB) و پیام‌های EML. این راهنما شما را از یک پروژهٔ تازه .NET تا کار با فایل‌های MSG در عرض چند دقیقه می‌برد.

پیش‌نیازها

RequirementDetail
.NET8.0 یا بالاتر
Package managerNuGet (dotnet CLI یا Visual Studio)
OSویندوز، macOS یا لینوکس
Dependenciesهیچ‌کدام — C# مدیریت‌شده خالص

نصب

نصب از NuGet:

dotnet add package Aspose.Email.Foss

در یک برنامهٔ کنسول ساده، تأیید کنید:

using Aspose.Email.Foss.Msg;

var message = MapiMessage.Create("Test", "Hello");
Console.WriteLine($"Subject: {message.Subject}");
// Output: Subject: Test

برای جزئیات تنظیم پروژه، راهنمای نصب را ببینید.

کاری که می‌توانید انجام دهید

پس از نصب می‌توانید فوراً:

  • خواندن فایل‌های MSG با MapiMessage.FromStream() یا MapiMessage.FromFile() — دسترسی به موضوع، متن، متن HTML، فرستنده، دریافت‌کنندگان و پیوست‌ها
  • ایجاد پیام‌های MSG از ابتدا با MapiMessage.Create() — تنظیم تمام فیلدها، افزودن دریافت‌کنندگان و پیوست‌ها، سپس سریال‌سازی با message.Save()
  • تبدیل بین MSG و EML (MIME/RFC 5322) با LoadFromEml() و SaveToEml()
  • بازرسی کانتینر باینری CFB زیرین با CfbReader — مرور ذخیره‌سازی‌ها و جریان‌ها، حل مسیرها، خواندن بایت‌های خام
  • نوشتن اسناد CFB با CfbWriter برای بازرسی قانونی یا ساخت فرمت
  • مدیریت پیوست‌ها — افزودن فایل، جریان یا پیوست‌های MSG توکار با متادیتای کامل

شروع سریع

یک فایل 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}");

foreach (var recipient in message.Recipients)
    Console.WriteLine($"To: {recipient.EmailAddress}");

foreach (var attachment in message.Attachments)
    Console.WriteLine($"Attachment: {attachment.Filename} ({attachment.MimeType})");

مراحل بعدی

 فارسی