الخصائص والوظائف
الخصائص والوظائف
هذه الصفحة تغطي كل ميزة رئيسية من إرسال رسالة خاصة إلى موقع الويب 26.3 مع نموذج Python.
قراءة ملفات MSG
تحميل ملف MSG والوصول إلى خصائصه الأساسية:
from aspose.email_foss.msg import MapiMessage
msg = MapiMessage.from_file("message.msg")
print(f"Subject: {msg.subject}")
print(f"Body: {msg.body}")
print(f"HTML Body: {msg.body_html}")
print(f"Message Class: {msg.message_class}")إنشاء ملفات MSG
إرسال رسالة جديدة من Scratch:
from aspose.email_foss.msg import MapiMessage
msg = MapiMessage.create("Meeting Notes", "Please find the notes attached.")
msg.save("new_message.msg")وضع الموضوع والجسم على رسالة موجودة:
msg.subject = "Updated Subject"
msg.body = "Updated body text"
msg.save("updated.msg")المستقبلات
إضافة المستلمين مع أسماء وأعضاء العرض:
from aspose.email_foss.msg import MapiMessage, RECIPIENT_TYPE_CC
msg = MapiMessage.create("Hello", "Message body")
msg.add_recipient("alice@example.com", display_name="Alice Smith")
msg.add_recipient("bob@example.com", display_name="Bob Jones", recipient_type=RECIPIENT_TYPE_CC)
msg.save("with_recipients.msg")الارتباطات
إضافة ملفات ثنائية:
with open("report.pdf", "rb") as f:
data = f.read()
msg.add_attachment("report.pdf", data, mime_type="application/pdf")
msg.save("with_attachment.msg")ضع رسالة MSG كملحق متصل:
inner = MapiMessage.create("Inner Subject", "Inner body")
msg.add_embedded_message_attachment(inner, filename="embedded.msg", mime_type="application/vnd.ms-outlook")
msg.save("with_embedded.msg")مميزات MAPI
اقرأ وكتب خصائص MAPI بواسطة ID الملكية:
from aspose.email_foss.msg import PropertyId
# Read a property
subject = msg.get_property(PropertyId.SUBJECT)
# Set a property
msg.set_property(PropertyId.SUBJECT, "New Subject")تخصيص جميع الممتلكات:
for prop in msg.iter_properties():
print(f"Tag: {prop.property_tag:#010x}")تحويل البريد الإلكتروني
تحويل بين MSG (MAPI) و البريد الإلكتروني (RFC 5322) تنسيقات:
# MSG to email string
email_str = msg.to_email_string()
print(email_str[:500])
# MSG to EmailMessage object
email_msg = msg.to_email_message()
# EmailMessage back to MapiMessage
msg2 = MapiMessage.from_email_message(email_msg)
msg2.save("roundtrip.msg")عمليات CFB منخفضة المستوى
اقرأ هيكل حاوية CFB مباشرة:
from aspose.email_foss.cfb import CFBReader
reader = CFBReader.from_file("message.msg")
print(f"File size: {reader.file_size} bytes")
print(f"Sectors: {reader.fat_sector_count}")
print(f"Entries: {reader.directory_entry_count}")
for entry in reader.iter_storages():
print(f"Storage: {entry}")
for entry in reader.iter_streams():
print(f"Stream: {entry}")
reader.close()كتابة وثائق CFB:
from aspose.email_foss.msg import MsgWriter
data = msg.to_bytes()
with open("output.msg", "wb") as f:
f.write(data)نصائح وأفضل الممارسات
- دائما الاتصال
msg.close()أو استخدام مدير السياق عند قراءة إصدار الملفات - استخدام
msg.validation_issuesالتحقق من مشاكل الامتثال لـ MSG format - وَالْمُتَّقِينَ
strictالمعلمات فيMapiMessage.from_file()التحكم في التسامح عن الأخطاء - إعدادFalseلينينت بارسينغ - يتم تحميل جميع بيانات الارتباط في ذاكرة أثناء
from_file()- الاستخدامatt.data- الوصول إلى الأبيتات مباشرة؛;iter_attachments_info()هو إيتراتور الراحة فوق قائمة الإضافات الشعبية بالفعل - استخدام
to_email_string()لالتقاط النص السريع دون بناء الكائنات الكاملة عبر البريد الإلكتروني
القضايا المشتركة
| مسألة | سبب | تصحيح |
|---|---|---|
CFBError عند تحميل | لا ملف CFB / MSG صالح | تحقق من أن الملف هو Outlook MSG الحقيقي |
| الجسم الفارغ بعد الحمل | الكائنات التي يتم تخزينها في HTML فقط | التحقق msg.body_html بدلاً من msg.body |
| المفقودين | MSG لا يحتوي على مخازن المستلمين | يتم اختيار المستقبلات في تنسيق MSG؛ التحقق من msg.recipients |
FAQ
ما هي الإصدارات التي يتم دعمها في تنسيق MSG؟?
يقرأ المكتبة ويكتب ملفات MSG في تنسيقات CFB v3 و v4 ، متوافقة مع Microsoft Outlook.
هل يمكنني قراءة ملفات EML؟?
لا مباشرة.المكتبة تتعامل مع تنسيق MSG.استخدام MapiMessage.from_email_message() تحويل من RFC 5322 EmailMessage الأجسام .
هل يتم دعم أمن الشرائح؟?
كل واحد منهم MapiMessage و CFBReader الوصول المتزامن إلى حالات منفصلة من الأسلاك المنفصلات آمن.
إشارة API
| الفئة / الطريقة | وصف |
|---|---|
MapiMessage | أعلى مستوى MSG رسالة التمثيل |
MapiMessage.from_file() | تحميل ملف MSG |
MapiMessage.create() | إرسال رسالة MSG جديدة |
MapiMessage.save() | حفظ ملف MSG |
MapiMessage.to_email_message() | تحويل إلى رسالة بريد إلكتروني (RFC 5322) |
MapiMessage.from_email_message() | تحويل من EmailMessage إلى MSG |
MapiMessage.add_recipient() | إضافة المستلم |
MapiMessage.add_attachment() | إضافة ملحق ثنائي |
MapiAttachment | التمسك برسالة |
MapiRecipient | المقبول على رسالة |
MapiProperty | خريطة العقارات الدخول |
CFBReader | قارئ حاوية CFB منخفض المستوى |
CFBWriter | كاتب حاويات CFB منخفض المستوى |
MsgReader | قارئ MSG الهيكل منخفض المستوى |