Erstellen eines benutzerdefinierten Kontaktelements
In diesem Beispiel wird gezeigt, wie ein benutzerdefiniertes Kontaktelement erstellt wird und sowohl vordefinierte als auch benutzerdefinierte Eigenschaften festgelegt werden.
Beispiel
Hinweis
Das folgende Codebeispiel ist ein Auszug aus Programming Applications für Microsoft Office Outlook 2007.
Ein ContactItem-Objekt stellt einen Kontakt im Ordner „Kontakte“ dar und verfügt über mehr als 100 integrierte Eigenschaften, wie z. B. FirstName und LastName. Manchmal sind die integrierten Eigenschaften nicht ausreichend, und Sie müssen benutzerdefinierte Eigenschaften hinzufügen, wozu Sie die UserProperties-Sammlung verwenden können.
Im folgenden Codebeispiel erstellt CreateCustomItem erstellt ein benutzerdefiniertes ContactItem-Objekt, gibt ihm den Namen „Shoe Store“ und ruft die Add(String, Object)-Methode auf, um es einem Ordner mit dem Namen „Shoe Store“ hinzuzufügen. CreateCustomItem ruft zunächst den Ordner „Shoe Store“ mithilfe der GetDefaultFolder(OlDefaultFolders)-Methode ab. Der Ordner „Shoe Store“ ist ein Unterordner des Standardordners für Kontakte. CreateCustomItem legt dann die Eigenschaften FirstName und LastName fest und erstellt eine benutzerdefinierte Eigenschaft („Shoe Size“) mithilfe der UserProperties-Sammlung.
Wenn Sie Visual Studio verwenden, um dieses Codebeispiel zu testen, müssen Sie der Microsoft Outlook 15.0-Objektbibliothekkomponente zuerst einen Verweis hinzufügen und die Outlook-Variable angeben, wenn Sie den Microsoft.Office.Interop.Outlook-Namespace importieren. Die using-Anweisung darf im Codebeispiel nicht direkt vor den Funktionen stehen, sondern muss vor der öffentlichen Class-Deklaration hinzugefügt werden. Die folgende Codezeile zeigt, wie Sie den Import und die Zuweisung in C# vornehmen.
using Outlook = Microsoft.Office.Interop.Outlook;
private void CreateCustomItem()
{
Outlook.Folder folder =
Application.Session.GetDefaultFolder(
Outlook.OlDefaultFolders.olFolderContacts).Folders[
"Shoe Store"] as Outlook.Folder;
Outlook.ContactItem contact =
folder.Items.Add(
"IPM.Contact.Shoe Store") as Outlook.ContactItem;
contact.FirstName = "Michael";
contact.LastName = "Affronti";
contact.UserProperties["Shoe Size"].Value = "9";
contact.Save();
}