Quickstart

Quickstart: ایجاد و خواندن یک فایل MSG

این راهنمای شما را از یک نصب تازه به یک فایل MSG کار در چند مرحله با استفاده از MapiMessage از aspose.email_foss.


Prerequisites

RequirementDetail
Python3.10 or later
پپنسخه فعلی
OSویندوز، macOS یا لینوکس
Dependenciesهیچ - Python خالص

مرحله اول: نصب بسته بندی

pip install aspose-email-foss

نصب را تایید کنید:

from aspose.email_foss.msg import MapiMessage
print("aspose-email-foss is ready.")

مرحله 2 - ایجاد یک فایل MSG

استفاده از MapiMessage.create() برای ایجاد یک پیام، ویژگی های ارسال را با PropertyId, یک گیرنده را اضافه کنید، فایل را به آن اضافه کرده و تماس بگیرید. save() برای نوشتن آن .msg تولید .

from datetime import datetime, timezone
from aspose.email_foss import msg

message = msg.MapiMessage.create("Hello from Python", "This is the message body.")
message.set_property(msg.PropertyId.SENDER_NAME, "Build Agent")
message.set_property(msg.PropertyId.SENDER_EMAIL_ADDRESS, "agent@example.com")
message.set_property(
    msg.PropertyId.MESSAGE_DELIVERY_TIME,
    datetime(2026, 1, 1, 9, 0, tzinfo=timezone.utc),
)
message.add_recipient("alice@example.com", display_name="Alice Example")
message.add_attachment("readme.txt", b"Hello, world!\n", mime_type="text/plain")
message.save("quickstart.msg")
print("quickstart.msg written.")

مرحله 3 – فایل MSG را بخوانید

فایل های ذخیره شده را با MapiMessage.from_file() و دسترسی به subject و body املاک مستقیماً.

from aspose.email_foss import msg

with msg.MapiMessage.from_file("quickstart.msg") as message:
    print(f"Subject : {message.subject}")
    print(f"Body    : {message.body}")

مرحله 4 – تبدیل به EML

to_email_message() بازگشت به Python استاندارد email.message.EmailMessage موضوع استفاده to_email_bytes() برای ارسال یک RFC 5322 آماده .eml فایل ها .

from pathlib import Path
from aspose.email_foss import msg

with msg.MapiMessage.from_file("quickstart.msg") as message:
    Path("quickstart.eml").write_bytes(message.to_email_bytes())
    print("quickstart.eml written.")

قدم های بعدی

See Also

 فارسی