UserProperties.Add(String, OlUserPropertyType, Object, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Interop.Outlook

Ensamblado:

Microsoft.Office.Interop.Outlook.dll

Crea una nueva propiedad de usuario en la UserProperties colección.

public Microsoft.Office.Interop.Outlook.UserProperty Add (string Name, Microsoft.Office.Interop.Outlook.OlUserPropertyType Type, object AddToFolderFields, object DisplayFormat);

Public Function Add (Name As String, Type As OlUserPropertyType, Optional AddToFolderFields As Object, Optional DisplayFormat As Object) As UserProperty

Parámetros

Name

String

El nombre de la propiedad. La longitud máxima es de 64 caracteres. Los caracteres, ' [', ']', '_' y '#', no se permiten en el nombre.

Type

OlUserPropertyType

Tipo de la nueva propiedad.

AddToFolderFields

Object

True si la propiedad se agregará como campo personalizado a la carpeta que el elemento se encuentra en. Este campo puede mostrarse en la vista de la carpeta. False si la propiedad se agregará como un campo personalizado para el elemento pero no para la carpeta. El valor predeterminado es True.

DisplayFormat

Object

Especifica cómo se mostrará la propiedad en la interfaz de usuario de Outlook. Este parámetro se puede establecer en un valor de una de varias enumeraciones diferentes, determinada por el tipo de propiedad especificado en el Type parámetro . Para obtener más información sobre cómo Type e DisplayFormat interactuar, vea DisplayFormat.

Devoluciones

UserProperty

Objeto UserProperty que representa la nueva propiedad.

Comentarios

Puede definir propiedades personalizadas llamando al método UserProperties.Add para un elemento o carpeta de Outlook o al Add(String, OlUserPropertyType, Object, Object) método de una carpeta.

Puede crear una propiedad de un tipo definido por la OlUserPropertyType enumeración, excepto para los tipos siguientes: olEnumeration, olOutlookInternaly olSmartFrom.

Para establecer por primera vez una propiedad creada por el método Add , use la Value propiedad del UserProperty objeto en lugar del SetProperties(Object, Object) método o SetProperty(String, Object) del PropertyAccessor objeto .

Si desea ver una propiedad personalizada en un elemento, debe usar el método UserProperties.Add para crear la propiedad. Las propiedades personalizadas creadas por PropertyAccessor no se admiten en una vista personalizada.

No puede agregar propiedades personalizadas a elementos de documento de Office tales como archivos de Word, Excel o PowerPoint. Recibirá un error al intentar agregar mediante programación un campo definido por el usuario a un DocumentItem objeto .