Compartir a través de

Crear un elemento de contacto personalizado

  • Artículo

En este ejemplo se muestra cómo crear un elemento de contacto personalizado y establecer las propiedades predefinidas y las definidas por el usuario.

Ejemplo

Nota:

El siguiente ejemplo de código es un fragmento de Programming Applications for Microsoft Office Outlook 2007 (Programación de aplicaciones para Microsoft Office Outlook 2007).

Un objeto ContactItem representa un contacto de la carpeta Contactos y tiene más de 100 propiedades integradas, como, por ejemplo, FirstName y LastName. A veces, las propiedades integradas no son suficientes y es necesario agregar propiedades personalizadas, lo que puede hacer mediante la colección UserProperties.

En el ejemplo de código siguiente, CreateCustomItem crea un objeto ContactItem personalizado, lo denomina "Shoe Store", y llama al método Add(String, Object) para agregarlo a una carpeta denominada "Shoe Store". En primer lugar, CreateCustomItem obtiene la carpeta "Shoe Store" mediante el método GetDefaultFolder(OlDefaultFolders). La carpeta "Shoe Store" es una subcarpeta de la carpeta Contactos predeterminada. Después, CreateCustomItem establece las propiedades FirstName y LastName, y crea una propiedad definida por el usuario ("Shoe Size") mediante la colección UserProperties.

Si usa Visual Studio para probar este ejemplo de código, primero debe agregar una referencia al componente de la biblioteca de objetos de Microsoft Outlook 15.0 y especificar la variable de Outlook al importar el espacio de nombres Microsoft.Office.Interop.Outlook. La instrucción using no debe producirse directamente antes de las funciones en el ejemplo de código, pero debe agregarse antes de la declaración de clase pública. La siguiente línea de código muestra cómo realizar la importación y la asignación en 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();
}

Vea también