הצגת Aspose.Email FOSS עבור .NET

מבוא

Aspose.Email FOSS for .NET היא ספרייה חינמית וקוד פתוח ב‑C# המאפשרת לך לעבוד עם Outlook
קבצי MSG, מכולות Compound File Binary (CFB) והודעות EML ישירות באפליקציית .NET שלך — ללא Microsoft Outlook, ללא אינטרופ COM, וללא צורך בספריות מקומיות. הפץ
אותה כחבילה יחידה של NuGet והיא פועלת באופן זהה ב‑Windows, Linux, macOS, מכולות Docker,
ובפונקציות ללא שרת.

הספרייה פותרת בעיה חוזרת בעבודה ארגונית ובאינטגרציה: קבצי Outlook .msg
נוצרים על ידי מיליוני משתמשי עסקים, אך פענוחם ללא Outlook דרש בעבר אוטומציה של COM או ספריות מסחריות יקרות. Aspose.Email FOSS for .NET מספקת
תמיכה מלאה בקריאה/כתיבה עבור MSG, מכולת הבינארית CFB הבסיסית, והפורמט EML/MIME —
הכל תחת רישיון MIT ללא מגבלות שימוש.

אם אתה בונה צינור ארכיון של דוא"ל, כלי הגירה, מחלץ קבצים מצורפים, או מחולל MSG אוטומטי, ספרייה זו נותנת לך גישה ישירה ברמת נמוכה לכל בת של פורמט הדוא"ל יחד עם API ברמה גבוהה MapiMessage שמאפשר לך להתחיל בתוך דקות.

תכונות מרכזיות

קריאת קבצי Outlook MSG

פתח כל קובץ .msg מנתיב או זרם באמצעות MsgReader.FromFile() או MsgReader.FromStream().
גש לזרם המאפיינים המלא של MAPI, לרשומות הנמענים ולתתיות המשנה של הקבצים המצורפים ברמת הבייט הגולמי דרך MsgStorage ו-MsgStream.

using System.IO;
using Aspose.Email.Foss.Msg;
using var stream = File.OpenRead("sample.msg");

var message = MapiMessage.FromStream(stream);
Console.WriteLine(message.Subject);

צור קבצי MSG מאפס

בנה הודעת דוא"ל מלאה באופן תכנותי באמצעות MapiMessage.Create(). הגדר את הנושא, גוף הטקסט הפשוט גוף ה-HTML, שם השולח, כתובת האימייל של השולח, זמן המשלוח, וזיהוי ההודעה באינטרנט, ואז הוסף נמענים עם AddRecipient() וקבצים מצורפים עם AddAttachment(). סדר עם message.Save().

using System.IO;
using Aspose.Email.Foss.Msg;

var message = MapiMessage.Create("Hello", "Body");
message.SenderName = "Alice";
message.SenderEmailAddress = "alice@example.com";
message.AddRecipient("bob@example.com", "Bob");
using var attachmentStream = new MemoryStream("abc"u8.ToArray());
message.AddAttachment("note.txt", attachmentStream, "text/plain");
using var output = File.Create("hello.msg");
message.Save(output);

המרת EML ל-MSG (וחזרה)

טען קובץ RFC 5322 סטנדרטי .eml לתוך MapiMessage עם MapiMessage.LoadFromEml(), לאחר מכן שמור אותו כקובץ Outlook .msg — או הפוך את התהליך עם MapiMessage.SaveToEml(). ה‑parser המובנה של MIME משמר את הנושא, הגוף, גוף HTML, השולח, הנמענים והקבצים המצורפים במהלך סבבי EML ↔ MSG מלאים.

using System.IO;
using Aspose.Email.Foss.Msg;
using var input = File.OpenRead("message.eml");

var message = MapiMessage.LoadFromEml(input);
using var msgOutput = File.Create("message.msg");
message.Save(msgOutput);
using var emlOutput = File.Create("roundtrip.eml");
message.SaveToEml(emlOutput);

גישה ברמת נמוכה למכולת CFB

קבצי MSG של Outlook נבנים על פורמט קובץ בינארי מורכב (CFB) — מכולה בינארית היררכית הדומה למערכת קבצים. CfbReader חושף את עץ הספריות המלא: חזור על אחסונים וזרמים עם IterStorages(), IterStreams(), ו-IterChildren(), נווט לרשומות ספציפיות לפי נתיב עם ResolvePath(), וקרא בתים גולמיים של הזרם עם GetStreamData().

CfbWriter מאפשר לך לבנות ולסדר מסמך CFB מאפס. צור CfbDocument, חבר צמתים CfbStorage ו‑CfbStream, וקרא ל‑CfbWriter.ToBytes() או CfbWriter.WriteFile() כדי לסדר.

גישה למאפייני MAPI וקבצים מצורפים

המחלקה MapiPropertyCollection מספקת גישה למאפייני MAPI מסוגים עבור כל MSG או אחסון
אובייקט: השתמשו בGet(), Set(), Add() וRemove() עם ערכי enum סטנדרטיים CommonMessagePropertyId
או PropertyTypeCode. גישה למטא‑נתוני קבצים מצורפים ולנתונים בינריים דרך
MapiAttachment מאפיינים: Filename, MimeType, ContentId וData.

התחלה מהירה

התקן את החבילה:

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(message.Subject);
Console.WriteLine(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})");

פורמטים נתמכים

קוד פתוח ורישוי

Aspose.Email FOSS for .NET משוחרר תחת רישיון MIT. אתה יכול להשתמש בו בחופשיות ב
אישי, מסחרי, ופרויקטים בקוד פתוח ללא מגבלות שימוש. קוד המקור הוא
זמין ב
github.com/aspose-email-foss/Aspose.Email-FOSS-for-.Net.

התחלה

• התחלה
• מדריך למפתחים
• מאמרי מאגר ידע
• תיעוד API