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

Définition

Espace de noms:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Crée une propriété utilisateur dans la UserProperties collection.

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

Paramètres

Name

String

Nom de la propriété. La longueur maximale est de 64 caractères. Les caractères « [ », « ] », « _ » et « # » ne sont pas autorisés dans le nom.

Type

OlUserPropertyType

Type de la nouvelle propriété.

AddToFolderFields

Object

True si la propriété est ajoutée en tant que champ personnalisé au dossier dans lequel se trouve l’élément. Ce champ peut être affiché dans l’affichage du dossier. False si la propriété est ajoutée en tant que champ personnalisé à l’élément, mais pas au dossier. La valeur par défaut est True.

DisplayFormat

Object

Spécifie le mode d’affichage de la propriété dans l’interface utilisateur Outlook. Ce paramètre peut être défini sur une valeur de l’une des différentes énumérations, déterminée par le type de propriété spécifié dans le Type paramètre . Pour plus d’informations sur la façon dont Type et DisplayFormat interagissent, consultez DisplayFormat.

Retours

UserProperty

Objet UserProperty qui représente la nouvelle propriété.

Remarques

Vous pouvez définir des propriétés personnalisées en appelant la méthode UserProperties.Add pour un élément ou un dossier Outlook, ou la Add(String, OlUserPropertyType, Object, Object) méthode pour un dossier.

Vous pouvez créer une propriété d’un type défini par l’énumération, à l’exception OlUserPropertyType des types suivants : olEnumeration, olOutlookInternalet olSmartFrom.

Pour définir pour la première fois une propriété créée par la méthode Add , utilisez la Value propriété de l’objet UserProperty au lieu de la SetProperties(Object, Object) méthode ou SetProperty(String, Object) de l’objet PropertyAccessor .

Si vous souhaitez afficher une propriété personnalisée dans un élément, vous devez utiliser la méthode UserProperties.Add pour créer cette propriété. Les propriétés personnalisées créées par ne PropertyAccessor sont pas prises en charge dans une vue personnalisée.

Vous ne pouvez pas ajouter de propriétés personnalisées dans des éléments de document Microsoft Office comme Word, Excel ou PowerPoint. Vous recevez une erreur lorsque vous essayez d’ajouter par programmation un champ défini par l’utilisateur à un DocumentItem objet.