UserProperties.Add(String, OlUserPropertyType, Object, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt eine neue Benutzereigenschaft in der UserProperties Auflistung.
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 UserPropertyParameter
- Name
- String
Der Name der Eigenschaft. Die Höchstlänge beträgt 64 Zeichen. Die Zeichen , ' [', ']', '_' und '#', sind im Namen nicht zulässig.
- Type
- OlUserPropertyType
Der Typ der neuen Eigenschaft.
- AddToFolderFields
- Object
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
- Object
Gibt an, wie die Eigenschaft auf der Outlook-Benutzeroberfläche angezeigt wird. Dieser Parameter kann auf einen Wert aus einer von mehreren verschiedenen Enumerationen festgelegt werden, der durch den im Type -Parameter angegebenen Eigenschaftstyp bestimmt wird. Weitere Informationen dazu, wie Type und DisplayFormat interagieren, finden Sie unter DisplayFormat.
Gibt zurück
Ein UserProperty -Objekt, das die neue Eigenschaft darstellt.
Hinweise
Sie können benutzerdefinierte Eigenschaften definieren, indem Sie entweder die UserProperties.Add-Methode für ein Outlook-Element oder -Ordner oder die Add(String, OlUserPropertyType, Object, Object) -Methode für einen Ordner aufrufen.
Sie können eine Eigenschaft eines Typs erstellen, der von der OlUserPropertyType -Enumeration definiert wird, mit Ausnahme der folgenden Typen: olEnumeration, olOutlookInternalund olSmartFrom.
Um zum ersten Mal eine Eigenschaft festzulegen, die von der Add-Methode erstellt wurde, verwenden Sie die Value -Eigenschaft des UserProperty -Objekts anstelle der - oder SetProperty(String, Object) -SetProperties(Object, Object)Methode des PropertyAccessor -Objekts.
Wenn Sie eine benutzerdefinierte Eigenschaft eines Elements anzeigen möchten, müssen Sie diese Eigenschaft mithilfe der UserProperties.Add-Methode erstellen. Benutzerdefinierte Eigenschaften, die von erstellt werden, PropertyAccessor werden in einer benutzerdefinierten Ansicht nicht unterstützt.
Office-Dokumentelementen wie z. B. Word-, Excel- oder PowerPoint-Dateien können keine benutzerdefinierten Eigenschaften hinzugefügt werden. Sie erhalten eine Fehlermeldung, wenn Sie versuchen, einem Objekt programmgesteuert ein benutzerdefiniertes DocumentItem Feld hinzuzufügen.