Quickstart
Quickstart: Το πρώτο αρχείο MSG σας στο C++
Αυτό το εγχειρίδιο δημιουργεί ένα πλήρες, εκτεταμένο παράδειγμα - συνθέτοντας ένα μήνυμα ηλεκτρονικού ταχυδρομείου, αποθηκεύοντας το ως αρχείο MSG, φορτώντας πίσω και μετατρέποντάς το σε EML - χρησιμοποιώντας μόνο τη τυποποιημένη βιβλιοθήκη C++ και Aspose.Email FOSS για C ++ .
Προϋποθέσεις
| ΑΠΑΙΤΗΣΕΙΣ | Λεπτομέρειες |
|---|---|
| ΕΠΙΛΟΓΗ | C++17 ή νεότερη (GCC 9+, Clang 10+, MSVC 2019+) |
| Συστήματα κατασκευής | ΚΕΦΑΛΑΙΟ 3.26 ή αργότερα |
| Βιβλιοθήκη | Κλωνοποιήθηκε από το GitHub (βλέπε Εγκατάσταση) |
| εξάρτηση | Κανένα |
Βήμα 1: Εισάγετε το CMakeLists.txt σας
cmake_minimum_required(VERSION 3.26)
project(email_quickstart)
add_subdirectory(Aspose.Email-FOSS-for-Cpp)
add_executable(quickstart main.cpp)
target_link_libraries(quickstart PRIVATE AsposeEmailFoss::AsposeEmailFoss)
set_target_properties(quickstart PROPERTIES CXX_STANDARD 17)Βήμα 2: Δημιουργία και αποθήκευση αρχείου MSG
Δημιουργήστε ένα νέο αρχείο MSG με θέμα, σώμα, αποστολέα, παραλήπτη και προσάρτημα:
#include <fstream>
#include <vector>
#include "aspose/email/foss/msg/mapi_message.hpp"
int main()
{
// Compose the message
auto message = aspose::email::foss::msg::mapi_message::create(
"Hello from Aspose.Email FOSS",
"This message was created programmatically — no Outlook required.");
message.set_sender_name("Alice");
message.set_sender_email_address("alice@example.com");
message.add_recipient("bob@example.com", "Bob");
message.add_attachment(
"readme.txt",
std::vector<std::uint8_t>{'H', 'e', 'l', 'l', 'o', '\n'},
"text/plain");
// Save to MSG file
std::ofstream out("hello.msg", std::ios::binary);
message.save(out);
return 0;
}Κτίστε και τρέξτε:
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
./build/quickstartΤο αρχείο hello.msg δημιουργείται στο εργασιακό κατάλογο.Ανοίξτε το στο Outlook για να επαληθεύσετε, Ακολουθείτε το βήμα 3 για να το διαβάσετε ξανά προγραμματικά.
Βήμα 3: Διαβάστε το αρχείο MSG πίσω
Κατεβάστε το αρχείο που μόλις δημιουργήσατε και εκτυπώστε τις ιδιότητές του:
#include <fstream>
#include <iostream>
#include "aspose/email/foss/msg/mapi_message.hpp"
int main()
{
std::ifstream input("hello.msg", std::ios::binary);
const auto message = aspose::email::foss::msg::mapi_message::from_stream(input);
std::cout << "Subject: " << message.subject() << '\n';
std::cout << "From: " << message.sender_name()
<< " <" << message.sender_email_address() << ">\n";
std::cout << "Body: " << message.body() << '\n';
std::cout << "Recipients: " << message.recipients().size() << '\n';
std::cout << "Attachments: " << message.attachments().size() << '\n';
for (const auto& a : message.attachments())
std::cout << " - " << a.filename << " (" << a.data.size() << " bytes)\n";
return 0;
}Αναμενόμενη παραγωγή:
Subject: Hello from Aspose.Email FOSS
From: Alice <alice@example.com>
Body: This message was created programmatically — no Outlook required.
Recipients: 1
Attachments: 1
- readme.txt (6 bytes)Βήμα 4: Μετατροπή σε EML
Μετατρέψτε το αρχείο MSG σε μορφή RFC 5322 / MIME με save_to_eml():
#include <filesystem>
#include <iostream>
#include "aspose/email/foss/msg/mapi_message.hpp"
int main()
{
const auto message = aspose::email::foss::msg::mapi_message::from_file(
std::filesystem::path("hello.msg"));
message.save_to_eml(std::filesystem::path("hello.eml"));
std::cout << "Saved hello.eml\n";
return 0;
}Το αντικείμενο, το σώμα, ο αποστολέας, οι παραλήπτες και η συνημμένη συντήρηση διατηρούνται στο έγγραφο EML.
Επόμενο Βήματα
- Εγκατάσταση — πλήρης εγκατάσταση του έργου CMake και υποστηριζόμενες πλατφόρμες
- Χαρακτηριστικά - πλήρης αναφορά χαρακτηριστικών με παραδείγματα C++
- Οδηγός Ανάπτυξης — MSG, EML, CFB και MAPI περιουσιακά διαδρομές
- FAQ — άδεια, υποστήριξη μορφής, γνωστούς περιορισμούς