Savybės
Funkcijos apžvalga
Aspose.Email FOSS for C++ suteikia daugiapakopę API darbui su Outlook MSG failais ir Compound File Binary (CFB) konteineriais. Bibliotekoje yra 26 viešosios klasės, suskirstytos į dvi posistemos: CFB ir MSG/MAPI.
CFB konteinerio prieiga
CFB posistemė skaito ir rašo Microsoft Compound File Binary formatą — konteinerio formatą, kuris yra pagrindas Outlook .msg failams.
| Class | Purpose |
|---|---|
cfb_reader | Atverti ir naršyti esamus CFB failus |
cfb_writer | Serializuoti CFB dokumentus į baitus arba failus |
cfb_document | Atminties atvaizdavimas CFB failui |
cfb_node | Individualus saugojimo arba srauto mazgas katalogų medyje |
cfb_storage | Pavadintas saugojimo įrašas |
cfb_stream | Pavadintas srautas su binariniais duomenimis |
Pagrindinės operacijos:
- Atidaryti iš failo, srauto arba baitų:
cfb_reader::from_file(),cfb_reader::from_stream(),cfb_reader::from_bytes(),cfb_reader::from_buffer() - Išvardyti turinį:
storage_ids(),stream_ids(),child_ids(),directory_entry_count() - Naršyti pagal kelią:
find_child_by_name(),resolve_path() - Patikrinti mazgus:
cfb_node::is_storage(),cfb_node::is_stream(),creation_time(),modified_time() - Rašyti konteinerius:
cfb_writer::to_bytes(),cfb_writer::write_file(),cfb_writer::write_stream()
MSG failo skaitymas ir rašymas
MSG posistemė apdoroja Outlook pranešimų formatą ant CFB.
| Klasė | Tikslas |
|---|---|
msg_reader | Atidaryti ir analizuoti MSG failus |
msg_writer | Serializuoti MSG dokumentus |
msg_document | Atmintyje saugoma MSG failo reprezentacija |
Pagrindinės operacijos:
- Atidaryti MSG failus:
msg_reader::from_file(),msg_reader::from_stream() - Patikrinti metaduomenis:
msg_document::major_version(),msg_document::minor_version(),msg_document::strict() - Rašyti MSG failus:
msg_writer::to_bytes(),msg_writer::write_file(),msg_writer::write_stream() - Konvertuoti į CFB:
msg_document::to_cfb_document()žemų lygių CFB prieigai
Aukšto lygio MAPI žinučių API
mapi_message klasė suteikia aukšto lygio sąsają kuriant, skaitant ir konvertuojant el. laiškų pranešimus.
Kuriant pranešimus:
mapi_message::create()— sukurti naują laišką su tema ir turiniuset_subject(),set_body(),set_html_body()— nustatyti pranešimo turinįset_sender_name(),set_sender_email_address(),set_sender_address_type()— nustatyti siuntėjąset_internet_message_id()— nustatyti Message-ID antraštęset_message_class()— nustatyti MAPI pranešimo klasęunicode_strings()/set_unicode_strings()— valdyti Unicode eilutės kodavimą
Įkeliami pranešimai:
mapi_message::from_file()— įkelti iš failo keliomapi_message::from_stream()— įkelti iš įvesties srautomapi_message::from_msg_document()— įkelti išmsg_document
Išsaugomi pranešimai:
save()— serializuoti į baitus, srautą arba failąto_msg_document()— konvertuoti įmsg_document, kad būtų galimas žemo lygio priėjimas
Priedai:
mapi_attachment::from_bytes(),mapi_attachment::from_stream()— įkelti priedo duomenismapi_attachment::is_embedded_message()— patikrinti, ar priedas yra įterptas MSGmapi_attachment::load_data()— pakrauti priedo turinį pagal poreikį
MAPI savybės:
mapi_property::property_id(),property_type(),property_tag()— savybių identifikavimasmapi_property::set_value(),flags(),set_flags()— savybių manipuliavimasmapi_property_collection::remove()— pašalinti savybes iš kolekcijos
EML ir MIME konvertavimas
Konvertuoti tarp Outlook MSG formato ir standartinio EML (RFC 5322 / MIME):
mapi_message::load_from_eml()— išanalizuoti.emlfailą įmapi_messagemapi_message::save_to_eml()— serializuotimapi_messageį EML formatą
Tema, turinys, siuntėjas, gavėjai ir priedai išlieka nepakitę per kelis perkelimus.
Enumai ir konstantos
| Enum | Tikslas |
|---|---|
common_message_property_id | Standartiniai MAPI savybių identifikatoriai (tema, turinys, siuntėjas, priedai) |
property_type_code | MAPI savybių tipų kodai (sveikasis skaičius, tekstas, dvejetainis, laikas, GUID) |
msg_storage_role | Saugojimo vaidmenys MSG failuose (žinutė, gavėjas, priedas) |
directory_object_type | CFB katalogo įrašo tipai (saugykla, srautas, šaknis) |
directory_color_flag | Raudono-juodo medžio spalvų vėliavos CFB katalogo įrašams |
sector_marker | Specialios sektoriaus reikšmės CFB failų paskirstymo lentelėse |