Création d’un contact personnalisé
Cet exemple montre comment créer un élément de contact personnalisé et définir les propriétés prédéfinies et définies par l’utilisateur.
Exemple
Remarque
L’exemple de code suivant est un extrait de programmation d’Applications pour Microsoft Office Outlook 2007.
Un objet ContactItem représente un contact dans le dossier Contacts et comporte plus de 100 propriétés intégrées, dont FirstName et LastName. Parfois, les propriétés intégrées ne sont pas suffisantes. Il faut alors ajouter des propriétés personnalisées, en utilisant la collection UserProperties.
Dans l’exemple de code suivant, CreateCustomItem crée un objet ContactItem personnalisé, le nomme « Shoe Store », et appelle la méthode Add(String, Object) pour l’ajouter à un dossier nommé « Shoe Store ». CreateCustomItem obtient d’abord le dossier « Shoe Store » en utilisant la méthode GetDefaultFolder(OlDefaultFolders). Le dossier « Shoe Store » est un sous-dossier du dossier Contacts par défaut. CreateCustomItem définit ensuite les propriétés FirstName et LastName, puis crée une propriété définie par l’utilisateur (« Shoe Size ») en utilisant la collection UserProperties.
Si vous utilisez Visual Studio pour tester cet exemple de code, vous devez d’abord ajouter une référence au composant Bibliothèque d’objets Microsoft Outlook 15.0 et spécifier la variable lorsque vous importez l’espace de noms Microsoft.Office.Interop.Outlook. L’instruction using ne doit pas se produire juste avant les fonctions de l’exemple de code, mais doit être ajoutée avant la déclaration publique. La ligne de code suivante montre comment effectuer l’importation et l’affectation dans C#.
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();
}