כיצד להתחיל עם 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");ה-parser המובנה של MIME משמר את הנושא, הגוף, גוף HTML, השולח, הנמענים ואת כל הקבצים המצורפים במהלך סבבי EML ↔ MSG מלאים.
הצעדים הבאים
- תכונות ופונקציונליות — הפניה מלאה לתכונות עם דוגמאות ב‑C#
- שאלות נפוצות — תשובות לשאלות נפוצות
- מדריך התקנה — הגדרת NuGet ודרישות גרסת .NET