Ciri-ciri
Gambaran Keseluruhan Ciri
Aspose.Email FOSS for C++ menyediakan API berlapis untuk bekerja dengan fail Outlook MSG dan kontena Compound File Binary (CFB). Perpustakaan ini mempunyai 26 kelas awam merentasi dua subsystem: CFB dan MSG/MAPI.
Akses Kontena CFB
Subsystem CFB membaca dan menulis format Microsoft Compound File Binary — format kontena yang menjadi asas fail Outlook .msg.
| Kelas | Tujuan |
|---|---|
cfb_reader | Buka dan lalui fail CFB sedia ada |
cfb_writer | Serialkan dokumen CFB kepada bait atau fail |
cfb_document | Representasi dalam memori bagi fail CFB |
cfb_node | Node storan atau aliran individu dalam pokok direktori |
cfb_storage | Entri storan bernama |
cfb_stream | Aliran bernama dengan data binari |
Operasi utama:
- Buka dari fail, aliran, atau bait:
cfb_reader::from_file(),cfb_reader::from_stream(),cfb_reader::from_bytes(),cfb_reader::from_buffer() - Senaraikan kandungan:
storage_ids(),stream_ids(),child_ids(),directory_entry_count() - Navigasi mengikut laluan:
find_child_by_name(),resolve_path() - Periksa nod:
cfb_node::is_storage(),cfb_node::is_stream(),creation_time(),modified_time() - Tulis kontena:
cfb_writer::to_bytes(),cfb_writer::write_file(),cfb_writer::write_stream()
MSG Baca dan Tulis Fail
Subsystem MSG mengendalikan format mesej Outlook di atas CFB.
| Class | Purpose |
|---|---|
msg_reader | Buka dan hurai fail MSG |
msg_writer | Serialkan dokumen MSG |
msg_document | Representasi dalam memori bagi fail MSG |
Operasi utama:
- Buka fail MSG:
msg_reader::from_file(),msg_reader::from_stream() - Periksa metadata:
msg_document::major_version(),msg_document::minor_version(),msg_document::strict() - Tulis fail MSG:
msg_writer::to_bytes(),msg_writer::write_file(),msg_writer::write_stream() - Tukar ke CFB:
msg_document::to_cfb_document()untuk akses CFB peringkat rendah
API Mesej MAPI Tahap Tinggi
Kelas mapi_message menyediakan antara muka peringkat tinggi untuk membuat, membaca, dan menukar mesej e‑mel.
Mencipta mesej:
mapi_message::create()— bina mesej baru dengan subjek dan badanset_subject(),set_body(),set_html_body()— tetapkan kandungan mesejset_sender_name(),set_sender_email_address(),set_sender_address_type()— tetapkan penghantarset_internet_message_id()— tetapkan pengepala Message-IDset_message_class()— tetapkan kelas mesej MAPIunicode_strings()/set_unicode_strings()— kendalikan pengekodan rentetan Unicode
Memuatkan mesej:
mapi_message::from_file()— muat dari laluan failmapi_message::from_stream()— muat dari aliran inputmapi_message::from_msg_document()— muat darimsg_document
Menyimpan mesej:
save()— siri ke bait, aliran, atau failto_msg_document()— tukar kepadamsg_documentuntuk akses aras rendah
Lampiran:
mapi_attachment::from_bytes(),mapi_attachment::from_stream()— memuat data lampiranmapi_attachment::is_embedded_message()— memeriksa sama ada lampiran adalah MSG terbenammapi_attachment::load_data()— memuat kandungan lampiran secara malas
ciri MAPI:
mapi_property::property_id(),property_type(),property_tag()— pengenalpastian sifatmapi_property::set_value(),flags(),set_flags()— manipulasi sifatmapi_property_collection::remove()— buang sifat dari koleksi
Penukaran EML dan MIME
Tukar antara format Outlook MSG dan EML standard (RFC 5322 / MIME):
mapi_message::load_from_eml()— parse sebuah fail.emlke dalammapi_messagemapi_message::save_to_eml()— serialize sebuahmapi_messageke format EML
Subjek, badan, penghantar, penerima, dan lampiran dipelihara melalui perjalanan pusingan.
Enum dan Konstanta
| Enum | Tujuan |
|---|---|
common_message_property_id | Pengenal sifat MAPI standard (subjek, badan, penghantar, lampiran) |
property_type_code | Kod jenis sifat MAPI (integer, string, binari, masa, GUID) |
msg_storage_role | Peranan storan dalam fail MSG (mesej, penerima, lampiran) |
directory_object_type | Jenis entri direktori CFB (storan, aliran, akar) |
directory_color_flag | Bendera warna pokok merah‑hitam untuk entri direktori CFB |
sector_marker | Nilai sektor khas dalam jadual peruntukan fail CFB |