الخصائص والوظائف

الخصائص والوظائف

الخصائص والوظائف

هذه الصفحة تغطي كل ميزة رئيسية من إرسال رسالة خاصة إلى موقع الويب 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 الهيكل منخفض المستوى
 العربية