UserProperties.Add(String, OlUserPropertyType, Object, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.