Funkcje
Przegląd funkcji
Aspose.Email FOSS for C++ zapewnia warstwowe API do pracy z plikami Outlook MSG oraz
kontenerami Compound File Binary (CFB). Biblioteka zawiera 26 publicznych klas w dwóch
podsystemach: CFB i MSG/MAPI.
Dostęp do kontenera CFB
Podsystem CFB odczytuje i zapisuje format Microsoft Compound File Binary — format kontenera będący podstawą plików Outlook .msg.
| Klasa | Cel |
|---|---|
cfb_reader | Otwieranie i przeglądanie istniejących plików CFB |
cfb_writer | Serializacja dokumentów CFB do bajtów lub plików |
cfb_document | Reprezentacja pliku CFB w pamięci |
cfb_node | Indywidualny węzeł przechowywania lub strumienia w drzewie katalogów |
cfb_storage | Nazwany wpis przechowywania |
cfb_stream | Nazwany strumień z danymi binarnymi |
Kluczowe operacje:
- Otwórz z pliku, strumienia lub bajtów:
cfb_reader::from_file(),cfb_reader::from_stream(),cfb_reader::from_bytes(),cfb_reader::from_buffer() - Wylicz zawartość:
storage_ids(),stream_ids(),child_ids(),directory_entry_count() - Nawiguj po ścieżce:
find_child_by_name(),resolve_path() - Sprawdź węzły:
cfb_node::is_storage(),cfb_node::is_stream(),creation_time(),modified_time() - Zapisz kontenery:
cfb_writer::to_bytes(),cfb_writer::write_file(),cfb_writer::write_stream()
MSG Odczyt i zapis pliku
Podsystem MSG obsługuje format wiadomości Outlook na bazie CFB.
| Klasa | Cel |
|---|---|
msg_reader | Otwieranie i analizowanie plików MSG |
msg_writer | Serializacja dokumentów MSG |
msg_document | Reprezentacja pliku MSG w pamięci |
Kluczowe operacje:
- Otwórz pliki MSG:
msg_reader::from_file(),msg_reader::from_stream() - Sprawdź metadane:
msg_document::major_version(),msg_document::minor_version(),msg_document::strict() - Zapisz pliki MSG:
msg_writer::to_bytes(),msg_writer::write_file(),msg_writer::write_stream() - Konwertuj do CFB:
msg_document::to_cfb_document()for low-level CFB access
Wysokopoziomowe API wiadomości MAPI
Klasa mapi_message zapewnia interfejs wysokiego poziomu do tworzenia, odczytywania i konwertowania wiadomości e‑mail.
Tworzenie wiadomości:
mapi_message::create()— utwórz nową wiadomość z tematem i treściąset_subject(),set_body(),set_html_body()— ustaw treść wiadomościset_sender_name(),set_sender_email_address(),set_sender_address_type()— ustaw nadawcęset_internet_message_id()— ustaw nagłówek Message-IDset_message_class()— ustaw klasę wiadomości MAPIunicode_strings()/set_unicode_strings()— kontroluj kodowanie ciągów Unicode
Ładowanie wiadomości:
mapi_message::from_file()— wczytaj z ścieżki plikumapi_message::from_stream()— wczytaj ze strumienia wejściowegomapi_message::from_msg_document()— wczytaj zmsg_document
Zapisywanie wiadomości:
save()— serializować do bajtów, strumienia lub plikuto_msg_document()— przekształcić wmsg_documentdo niskopoziomowego dostępu
Załączniki:
mapi_attachment::from_bytes(),mapi_attachment::from_stream()— wczytaj dane załącznikamapi_attachment::is_embedded_message()— sprawdź, czy załącznik jest osadzonym MSGmapi_attachment::load_data()— leniwe wczytywanie zawartości załącznika
Właściwości MAPI:
mapi_property::property_id(),property_type(),property_tag()— identyfikacja właściwościmapi_property::set_value(),flags(),set_flags()— manipulacja właściwościamimapi_property_collection::remove()— usuwanie właściwości z kolekcji
Konwersja EML i MIME
Konwertuj między formatem Outlook MSG a standardowym EML (RFC 5322 / MIME):
mapi_message::load_from_eml()— parsować plik.emldomapi_messagemapi_message::save_to_eml()— serializowaćmapi_messagedo formatu EML
Temat, treść, nadawca, odbiorcy i załączniki są zachowywane podczas wielokrotnych przetworzeń.
Wyliczenia i stałe
| Enum | Cel |
|---|---|
common_message_property_id | Standardowe identyfikatory właściwości MAPI (temat, treść, nadawca, załączniki) |
property_type_code | Kody typów właściwości MAPI (liczba całkowita, ciąg znaków, binarny, czas, GUID) |
msg_storage_role | Role przechowywania w plikach MSG (wiadomość, odbiorca, załącznik) |
directory_object_type | Typy wpisów katalogu CFB (przechowywanie, strumień, root) |
directory_color_flag | Flagi koloru drzewa czerwono-czarnego dla wpisów katalogu CFB |
sector_marker | Specjalne wartości sektorów w tabelach przydziału plików CFB |