مخاطبین بخش مهمی از هر سرویس گیرنده ایمیل هستند، زیرا با به خاطر سپردن تمام مخاطبین کاربر، مشابه مخاطبین روی تلفن هوشمند شما، کاربر را تسهیل می کنند. مخاطبین Outlook اطلاعات زیادی را در مورد یک شخص ذخیره می کنند، مانند نام، آدرس، شماره تماس، آدرس ایمیل و غیره. این مخاطبین را می توان در قالب های MSG و VCF ذخیره کرد. ممکن است خود را در سناریوهایی بیابید که باید مخاطبین MSG یا VCF را به صورت برنامه‌نویسی ایجاد یا تغییر دهید. برای آن، این مقاله به شما نحوه کار با مخاطبین MSG و VCF را با استفاده از C++ آموزش می‌دهد.

C++ API برای کار با مخاطبین MSG و VCF

Aspose.Email for C++ یک کتابخانه بومی C++ برای ایجاد، دستکاری، و ارسال ایمیل بدون نیاز به نصب Microsoft Outlook است. API همچنین از کار با مخاطبین و تقویم ها پشتیبانی می کند. می‌توانید API را از طریق NuGet نصب کنید یا آن را مستقیماً از بخش Downloads دانلود کنید.

PM> Install-Package Aspose.Email.Cpp

مخاطبین MSG و VCF ایجاد کنید

در این قسمت با نحوه ایجاد مخاطب Outlook و ذخیره آن در فرمت MSG و VCF آشنا می شوید. مراحل زیر برای دستیابی به آن ذکر شده است.

کد نمونه زیر نحوه ایجاد مخاطب Outlook و ذخیره آن در فرمت MSG و VCF با استفاده از C++ را نشان می دهد.

// یک نمونه از کلاس MapiContact برای نمایش مخاطب ایجاد کنید
System::SharedPtr<MapiContact> contact = System::MakeObject<MapiContact>();

// ویژگی های مخاطب را تنظیم کنید
System::SharedPtr<MapiContact> contact = System::MakeObject<MapiContact>();
contact->set_NameInfo(System::MakeObject<MapiContactNamePropertySet>(u"John", u"A.", u"Doe"));
contact->set_ProfessionalInfo(System::MakeObject<MapiContactProfessionalPropertySet>(u"Awthentikz", u"Social work assistant"));
contact->get_PersonalInfo()->set_PersonalHomePage(u"aspose.com");
contact->get_PhysicalAddresses()->get_HomeAddress()->set_Address(u"Im Astenfeld 59 8580 EDELSCHROTT");
contact->get_ElectronicAddresses()->set_Email1(System::MakeObject<MapiContactElectronicAddress>(u"test", u"SMTP", u"JohnADoe@test.com"));
contact->set_Telephones(System::MakeObject<MapiContactTelephonePropertySet>(u"06605045265"));
contact->get_PersonalInfo()->set_Children(System::MakeArray<System::String>({ u"child1", u"child2", u"child3" }));
contact->set_Categories(System::MakeArray<System::String>({ u"category1", u"category2", u"category3" }));
contact->set_Mileage(u"Some test mileage");
contact->set_Billing(u"Test billing information");
contact->get_OtherFields()->set_ReminderTime(System::DateTime(2022, 1, 1, 0, 0, 55));
contact->get_OtherFields()->set_UserField1(u"ContactUserField1");
contact->get_OtherFields()->set_UserField2(u"ContactUserField2");
contact->get_OtherFields()->set_UserField3(u"ContactUserField3");
contact->get_OtherFields()->set_UserField4(u"ContactUserField4");

// یک تصویر اضافه کنید
{
    System::SharedPtr<System::IO::FileStream> fs = System::IO::File::OpenRead(u"SourceDirectory\\Desert.jpg");
    System::ArrayPtr<uint8_t> buffer = System::MakeArray<uint8_t>(fs->get_Length(), 0);
    fs->Read(buffer, 0, buffer->get_Length());
    contact->set_Photo(System::MakeObject<MapiContactPhoto>(buffer, Aspose::Email::Mapi::MapiContactPhotoImageFormat::Jpeg));
}

// مخاطب را در قالب MSG ذخیره کنید
contact->Save(u"OutputDirectory\\MapiContact_out.msg", Aspose::Email::Mapi::ContactSaveFormat::Msg);

// مخاطب را با فرمت VCF ذخیره کنید
contact->Save(u"OutputDirectory\\MapiContact_out.vcf", Aspose::Email::Mapi::ContactSaveFormat::VCard);
تماس ایجاد شده توسط کد نمونه

تماس ایجاد شده توسط کد نمونه

مخاطبین MSG و VCF را بخوانید

Aspose.Email برای C++ از خواندن مخاطبین در هر دو فرمت MSG و VCF پشتیبانی می کند. در اینجا نحوه باز کردن مخاطبین MSG و VCF را با استفاده از C++ مشاهده خواهید کرد.

MSG Contact را بخوانید

مراحل زیر برای خواندن مخاطب MSG آمده است.

کد زیر نمونه ای برای خواندن مخاطب MSG با استفاده از C++ است.

// فایل تماس را بارگیری کنید
System::SharedPtr<MapiMessage> msg = MapiMessage::FromFile(u"SourceDirectory\\Contact.msg");
System::SharedPtr<MapiContact> mapiContact = System::DynamicCast<Aspose::Email::Mapi::MapiContact>(msg->ToMapiMessageItem());

// نمایش اطلاعات تماس
System::Console::WriteLine(mapiContact->get_NameInfo()->get_DisplayName());
System::Console::WriteLine(mapiContact1->get_PhysicalAddresses()->get_HomeAddress()->get_Address());
System::Console::WriteLine(mapiContact->get_Telephones()->get_PrimaryTelephoneNumber());
System::Console::WriteLine(mapiContact->get_ElectronicAddresses()->get_Email1());

مخاطب VCF را باز کنید

برای خواندن یک مخاطب VCF، به سادگی مخاطب را با استفاده از روش MapiContact::FromVCard بارگذاری کنید. کد نمونه زیر نحوه خواندن یک مخاطب VCF را با استفاده از C++ نشان می دهد.

// فایل تماس را بارگیری کنید
System::SharedPtr<MapiContact> mapiContact = MapiContact::FromVCard(u"SourceDirectory\\Contact.vcf");

// نمایش اطلاعات تماس
System::Console::WriteLine(mapiContact->get_NameInfo()->get_DisplayName());
System::Console::WriteLine(mapiContact1->get_PhysicalAddresses()->get_HomeAddress()->get_Address());
System::Console::WriteLine(mapiContact->get_Telephones()->get_PrimaryTelephoneNumber());
System::Console::WriteLine(mapiContact->get_ElectronicAddresses()->get_Email1());

مخاطبین MSG و VCF را تغییر دهید

به منظور تغییر یک مخاطب MSG/VCF، مخاطب را همانطور که در بخش قبل نشان داده شد باز کنید و سپس ویژگی های آن را تغییر دهید. مراحل زیر برای تغییر مخاطبین آورده شده است.

کد نمونه زیر نحوه تغییر مخاطبین MSG/VCF را با استفاده از C++ نشان می دهد.

// فایل تماس را بارگیری کنید
System::SharedPtr<MapiMessage> msg = MapiMessage::FromFile(u"SourceDirectory\\Contact.msg");
System::SharedPtr<MapiContact> mapiContact = System::DynamicCast<Aspose::Email::Mapi::MapiContact>(msg->ToMapiMessageItem());

// مشخصات تماس را اصلاح کنید
mapiContact->set_NameInfo(System::MakeObject<MapiContactNamePropertySet>(u"John", u"A.", u"Doe"));

// مخاطب را ذخیره کنید
mapiContact->Save(u"OutputDirectory\\MapiContact_out.msg", Aspose::Email::Mapi::ContactSaveFormat::Msg);

مجوز رایگان دریافت کنید

با درخواست [مجوز موقت رایگان] می‌توانید API را بدون محدودیت ارزیابی امتحان کنید.

نسخه نمایشی زنده

نتیجه

در این مقاله نحوه کار با مخاطبین MSG و VCF با استفاده از C++ را یاد گرفتید. به طور خاص، نحوه ایجاد، خواندن و تغییر مخاطبین را با استفاده از Aspose.Email برای C++ API یاد گرفته‌اید. API مجموعه ای از ویژگی های اضافی را برای خودکارسازی وظایف مربوط به ایمیل شما ارائه می دهد. می‌توانید با مراجعه به مستندات رسمی API را با جزئیات بررسی کنید. اگر سؤالی دارید، لطفاً با ما در تالار گفتمان پشتیبانی رایگان تماس بگیرید.

همچنین ببینید