UserProperties.Add-Methode (Outlook)

Erstellt eine neue Benutzereigenschaft in der UserProperties-Auflistung .

Syntax

Ausdruck. Add (Name, Type, AddToFolderFields, DisplayFormat)

Ausdruck Eine Variable, die ein UserProperties-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
Name	Erforderlich	String	Der Name der Eigenschaft. Die Höchstlänge beträgt 64 Zeichen. Die Zeichen , ' [', ']', '_' und '#', sind im Namen nicht zulässig.
Typ	Erforderlich	OlUserPropertyType	Der Typ der neuen Eigenschaft.
AddToFolderFields	Optional	Boolean	True, wenn die Eigenschaft dem Ordner, in dem sich das Element befindet, als benutzerdefiniertes Feld hinzugefügt werden soll. Dieses Feld kann in der Ordneransicht angezeigt werden. False, wenn die Eigenschaft als benutzerdefiniertes Feld zum Element hinzugefügt wird, jedoch nicht zum Ordner. Der Standardwert ist True.
DisplayFormat	Optional	Long	Gibt an, wie die Eigenschaft auf der Outlook-Benutzeroberfläche angezeigt wird. Dieser Parameter kann auf einen Wert aus einer mehrere verschiedene Enumerationen, anhand der in der Type -Parameter angegebenen OlUserPropertyType -Konstante festgelegt werden. Weitere Informationen dazu, wie Typ und DisplayFormat interagieren, finden Sie unter DisplayFormat-Eigenschaft.

Rückgabewert

Ein UserProperty-Objekt , das die neue Eigenschaft darstellt.

HinwBemerkungeneise

Sie können benutzerdefinierte Eigenschaften definieren, indem Sie entweder die UserProperties.Add-Methode für ein Outlook-Element oder einen Outlook-Ordner oder die UserDefinedProperties.Add-Methode für einen Ordner aufrufen.

Sie können eine Eigenschaft eines Typs, der durch die OlUserPropertyType -Aufzählung, außer für die folgenden Typen definierten erstellen: olEnumeration, olOutlookInternalund olSmartFrom.

Um zum ersten Mal eine Eigenschaft festzulegen, die von der UserProperties.Add-Methode erstellt wurde, verwenden Sie die UserProperty.Value-Eigenschaft anstelle der SetProperties - und SetProperty-Methoden des PropertyAccessor-Objekts .

Wenn Sie eine benutzerdefinierte Eigenschaft eines Elements anzeigen möchten, müssen Sie diese Eigenschaft mithilfe der UserProperties.Add-Methode erstellen. Von PropertyAccessor erstellte benutzerdefinierte Eigenschaften werden in einer benutzerdefinierten Ansicht nicht unterstützt.

Sie können Office-Dokumentelementen wie Word-, Excel- oder PowerPoint-Dateien keine benutzerdefinierten Eigenschaften hinzufügen. Sie erhalten eine Fehlermeldung, wenn Sie versuchen, einem DocumentItem-Objekt programmgesteuert ein benutzerdefiniertes Feld hinzuzufügen.

Beispiel

In diesem VBA-Beispiel wird ein neues ContactItem-Objekt erstellt und "LastDateSpokenWith" als benutzerdefinierte Eigenschaft hinzugefügt.

Sub AddUserProperty() 
 Dim myItem As Outlook.ContactItem 
 Dim myUserProperty As Outlook.UserProperty 
 
 Set myItem = Application.CreateItem(olContactItem) 
 Set myUserProperty = myItem.UserProperties _ 
 .Add("LastDateSpokenWith", olDateTime) 
 myItem.Display 
End Sub

In diesem VBA-Beispiel wird ein neues ContactItem-Objekt erstellt und „Details“ als Benutzereigenschaft hinzugefügt. Der Wert wird durch das Ändern der Eigenschaft Wert des UserProperty-Objekts festgelegt.

Sub AddUserProperty() 
 Dim myItem As Outlook.ContactItem 
 Dim myUserProperty As Outlook.UserProperty 
 
 Set myItem = Application.CreateItem(olContactItem) 
 Set myUserProperty = myItem.UserProperties _ 
 .Add("Details", olText) 
 myUserProperty.Value = "Neighbor" 
 myItem.Display 
End Sub

Siehe auch

UserProperties-Objekt

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.