Outlook संपर्क प्रबंधन

यह लेख स्टैंडअलोन Outlook को कवर करता है MapiContact आइटम MSG या vCard (VCF) के रूप में सहेजे गए। फॉर्मेट-न्यूट्रल के लिए VCardContact क्लास जो vCard फ़ाइलों को सीधे पढ़ता और लिखता है, देखें vCard (VCF) फ़ाइलों के साथ काम करना. PST के भीतर संपर्क संग्रहीत और पढ़ने के लिए, देखें PST फ़ाइलों में संपर्कों का प्रबंधन.

MapiMessage की तरह, Aspose.Email आपको Outlook संपर्क बनाने की अनुमति देता है। MapiContact क्लास Outlook संपर्क बनाने के लिए आवश्यक सभी संपर्क-संबंधी प्रॉपर्टीज़ प्रदान करता है। यह लेख दर्शाता है कि Outlook संपर्क को कैसे बनाएँ, सहेजें और पढ़ें। MapiContact क्लास।

Outlook संपर्क बनाएं और सहेजें

संपर्क बनाने और इसे डिस्क पर सेव करने के लिए:

  1. के नए ऑब्जेक्ट का उदाहरण बनाएं MapiContact क्लास।
  2. संपर्क प्रॉपर्टी जानकारी दर्ज करें।
  3. फ़ोटो डेटा जोड़ें (यदि कोई हो)।
  4. संपर्क को MSG या VCard स्वरूप में सहेजें।

निम्नलिखित कोड स्निपेट दिखाता है कि Outlook संपर्क कैसे बनाएं और सहेजें।

// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook();

MapiContact contact = new MapiContact();
contact.NameInfo = new MapiContactNamePropertySet("Bertha", "A.", "Buell");
contact.ProfessionalInfo = new MapiContactProfessionalPropertySet("Awthentikz", "Social work assistant");
contact.PersonalInfo.PersonalHomePage = "B2BTies.com";
contact.PhysicalAddresses.WorkAddress.Address = "Im Astenfeld 59 8580 EDELSCHROTT";
contact.ElectronicAddresses.Email1 = new MapiContactElectronicAddress("Experwas", "SMTP", "BerthaABuell@armyspy.com");
contact.Telephones = new MapiContactTelephonePropertySet("06605045265");
contact.PersonalInfo.Children = new string[] { "child1", "child2", "child3" };
contact.Categories = new string[] { "category1", "category2", "category3" };
contact.Mileage = "Some test mileage";
contact.Billing = "Test billing information";
contact.OtherFields.Journal = true;
contact.OtherFields.Private = true;
contact.OtherFields.ReminderTime = new DateTime(2014, 1, 1, 0, 0, 55);
contact.OtherFields.ReminderTopic = "Test topic";
contact.OtherFields.UserField1 = "ContactUserField1";
contact.OtherFields.UserField2 = "ContactUserField2";
contact.OtherFields.UserField3 = "ContactUserField3";
contact.OtherFields.UserField4 = "ContactUserField4";

// Add a photo
using (FileStream fs = File.OpenRead(dataDir + "Desert.jpg"))
{
    byte[] buffer = new byte[fs.Length];
    fs.Read(buffer, 0, buffer.Length);
    contact.Photo = new MapiContactPhoto(buffer,
        MapiContactPhotoImageFormat.Jpeg);
}
// Save the Contact in MSG format
contact.Save(dataDir + "MapiContact_out.msg",ContactSaveFormat.Msg);

// Save the Contact in VCF format
contact.Save(dataDir + "MapiContact_out.vcf", ContactSaveFormat.VCard);

MAPI वितरण सूचियों को VCF फ़ाइलों में सहेजें

निम्न कोड नमूना दर्शाता है कि वितरण सूची को मल्टी-कॉन्टैक्ट VCF फ़ाइल में कैसे सहेजा जाए:

// convert the `msg` object to a `MapiDistributionList` object
var dlist = (MapiDistributionList)msg.ToMapiMessageItem();

//save the distribution list
var options = new MapiDistributionListSaveOptions(ContactSaveFormat.VCard);
dlist.Save("distribution_list.vcf", options);

मल्टी-कॉन्टैक्ट VCF फ़ाइलों को MapiDistributionList में परिवर्तित करें

Aspose.Email मल्टी-कॉन्टैक्ट VCF फ़ाइलों को रूपान्तरण का समर्थन करता है MapiDistributionList ऑब्जेक्ट्स, जिससे कई संपर्कों को सीधे आपके अनुप्रयोगों में प्रबंधित और आयात करना आसान हो जाता है। यह सुविधा निम्न स्थैतिक विधियों के माध्यम से सुलभ है MapiDistributionList क्लास:

निम्न कोड नमूना दर्शाता है कि इस सुविधा का उपयोग कैसे करें:

// Convert a multi-contact VCF file to a MapiDistributionList
MapiDistributionList dlist = MapiDistributionList.FromVCF(fileName);

संपर्कों को VCF फ़ॉर्मेट में सहेजें

संपर्क को संस्करण 3 VCF स्वरूप में सहेजने के लिए, उपयोग करें VCardVersion एन्यूमरेशन ताकि सेट किया जा सके VCardSaveOptions.Version प्रॉपर्टी। निम्नलिखित नमूना कोड उपयोग को दर्शाता है VCardVersion एन्यूमरेशन में लोड करें ताकि संपर्क VCF संस्करण 3 फ़ॉर्मेट सहेजा जा सके:

var options = new MapiDistributionListSaveOptions(ContactSaveFormat.VCard);
options.Version = VCardVersion.V30;
dlist.Save("distribution_list.vcf", options);

MAPI संपर्क पढ़ना

यह MapiContact क्लास का उपयोग दोनों Outlook MSG और VCard प्रारूप के संपर्क लोड करने के लिए किया जा सकता है। निम्न कोड स्निपेट दर्शाता है कि MSG और VCF के रूप में सहेजे गए Outlook संपर्क को कैसे लोड किया जाए। MapiContact.

MSG फ़ाइलों से संपर्क लोड करें

निम्न कोड स्निपेट दर्शाता है कि MSG से संपर्क कैसे लोड किए जाएं।

MapiMessage msg = MapiMessage.FromFile(dataDir + "Contact.msg");
MapiContact contact = (MapiContact)msg.ToMapiMessageItem();

Console.WriteLine(contact.NameInfo.DisplayName);

VCard से संपर्क लोड करें

निम्नलिखित कोड स्निपेट दिखाता है कि कैसे vCard फ़ाइल को एक MapiContact के उपयोग से FromVCard मेथड। vCard को एक VCardContact के बजाय, देखें vCard (VCF) फ़ाइलों के साथ काम करना.

MapiContact contact = MapiContact.FromVCard(dataDir + "Contact.vcf");

कस्टम विकल्पों के साथ vCard से MAPI संपर्क लोड करें

vCard (.vcf) फ़ाइलों को MAPI संपर्कों में बदलते समय अधिक लचीलापन प्रदान करने के लिए, Aspose.Email for .NET एक अधिभार प्रदान करता है MapiContact.FromVCard(string filePath, VCardLoadOptions options) विधि जो स्वीकार करती है एक VCardLoadOptions ऑब्जेक्ट। यह vCard फ़ाइलों की व्याख्या पर बेहतर नियंत्रण प्रदान करता है - विशेष रूप से विभिन्न vCard फ़ॉर्मेट, एन्कोडिंग, या उन्नत पार्सिंग परिदृश्यों के साथ काम करते समय।

निम्न कोड नमूना दर्शाता है कि .vcf संपर्क फ़ाइल को कैसे लोड किया जाए MapiContact ऑब्जेक्ट का उपयोग करके अधिभार जिसे स्वीकार करता है VCardLoadOptions. लोड किया गया संपर्क फिर PST फ़ाइलों, MSG निर्यात, या अन्य Outlook-अनुकूल प्रारूपों में उपयोग किया जा सकता है।

var mapiContact = MapiContact.FromVCard("contact.vcf", new VCardLoadOptions());
Console.WriteLine(mapiContact.NameInfo.DisplayName);

निर्दिष्ट एन्कोडिंग के साथ VCard से संपर्क लोड करें

vCard फ़ाइल की एन्कोडिंग निर्दिष्ट की जाती है PreferredEncoding की प्रॉपर्टी VCardLoadOptions क्लास। निम्नलिखित कोड स्निपेट दिखाता है कि कैसे निर्दिष्ट एन्कोडिंग के साथ VCard से संपर्क लोड करें।

var loadOptions = new VCardLoadOptions { PreferredEncoding = Encoding.UTF8 };
var contactReadFromFile = MapiContact.FromVCard(dataDir + @"Contact.vcf", loadOptions);

विस्तारित फ़ील्ड्स के साथ VCard फ़ाइलें सहेजें

यह UseExtensions प्रॉपर्टी आपको नियंत्रित करने देती है कि vCard फ़ाइलों को सहेजते समय विस्तारित फ़ील्ड्स का उपयोग किया जाए या नहीं। जब true (डिफ़ॉल्ट) पर सेट किया जाता है, तो एक्सटेंशन की अनुमति होती है, जिससे कस्टम फ़ील्ड्स और अतिरिक्त संपर्क जानकारी के साथ संगतता मिलती है।

निम्नलिखित कोड नमूना दिखाता है कि संपर्क सहेजते समय विस्तारित फ़ील्ड को कैसे निष्क्रिय करें:

var contact = MapiContact.FromVCard("contact.vcf");

var options = new VCardSaveOptions
{
    UseExtensions = false
};

contact.Save("contact_out.vcf", options);

vCard फ़ाइलों के साथ सीधे काम करना

फॉर्मेट-न्यूट्रल के साथ vCard (VCF) फ़ाइलों को पढ़ना और लिखना VCardContact क्लास — एकल या कई संपर्क लोड करना, टेक्स्ट एन्कोडिंग चुनना, विशिष्ट vCard संस्करण के साथ सहेजना, और एसिंक्रोनस लोडिंग — एक समर्पित लेख में कवर किया गया है: vCard (VCF) फ़ाइलों के साथ काम करना.

संपर्क जानकारी को MHTML में रेंडर करें

Outlook संपर्क को Aspose.Email API का उपयोग करके MHTML में परिवर्तित किया जा सकता है। यह उदाहरण दर्शाता है कि VCard को कैसे लोड किया जाता है MapiContact और फिर MHTML में परिवर्तित किया गया … की मदद से MailMessage API।

//Load VCF Contact and convert to MailMessage for rendering to MHTML
var contact = MapiContact.FromVCard("Contact.vcf");

MemoryStream ms = new MemoryStream();
contact.Save(ms, ContactSaveFormat.Msg);
ms.Position = 0;
MapiMessage msg = MapiMessage.Load(ms, new MsgLoadOptions());
MailConversionOptions op = new MailConversionOptions();
MailMessage eml = msg.ToMailMessage(op);

//Prepare the MHT format options
MhtSaveOptions mhtSaveOptions = new MhtSaveOptions();
mhtSaveOptions.CheckBodyContentEncoding = true;
mhtSaveOptions.PreserveOriginalBoundaries = true;
MhtFormatOptions formatOp = MhtFormatOptions.WriteHeader | MhtFormatOptions.RenderVCardInfo;
mhtSaveOptions.RenderedContactFields = ContactFieldsSet.NameInfo | ContactFieldsSet.PersonalInfo | ContactFieldsSet.Telephones | ContactFieldsSet.Events;
mhtSaveOptions.MhtFormatOptions = formatOp;
eml.Save("ContactMhtml_out.mhtml", mhtSaveOptions);

साथ ही देखें

संदेश अटैचमेंट्स का प्रबंधन डिस्ट्रिब्यूशन लिस्ट्स के साथ काम करना