Outlook) (UserProperties.Add 方法

在 UserProperties 集合中建立新的使用者屬性。

語法

運算式。新增 (名稱、 類型、 AddToFolderFields、 DisplayFormat)

運算式 代表 UserProperties 物件的變數。

參數

名稱 必要/選用 資料類型 描述
Name 必要 字串 屬性的名稱。 最大長度為 64 個字元。 名稱中不允許使用字元 '['、']'、'_' 和 '#'。
Type 必要 OlUserPropertyType 新屬性的類型。
AddToFolderFields 選用 布林值 如果屬性將新增為自訂欄位至項目所在資料夾,則為 True。 此欄位可顯示在資料夾的檢視中。 如果屬性將作為自訂欄位新增至項目,而不是新增至資料夾,則為 False。 預設值為 True。
DisplayFormat 選用 Long 會指定屬性將如何在 Outlook 使用者介面中顯示。 此參數可以設定為數個不同列舉中的某個值,這點必須由 Type 參數中所指定的 OlUserPropertyType 常數決定。 如需 Type 與 DisplayFormat 如何互動的詳細資訊,請參閱 DisplayFormat 屬性。

傳回值

代表新屬性的 UserProperty 物件。

註解

您可以呼叫 Outlook 項目或資料夾的 UserProperties.Add 方法,或資料夾的 UserDefinedProperties.Add 方法,來定義自訂屬性。

您可以建立由 OlUserPropertyType 列舉所定義的類型屬性,但下列類型除外: olEnumeration、 olOutlookInternal 和 olSmartFrom。

若要第一次設定 UserProperties.Add 方法所建立的屬性,請使用 UserProperty.Value 屬性,而不是 PropertyAccessor 物件的 SetProperties 和 SetProperty 方法。

如果您想要檢視某個項目的自訂屬性,就必須使用 UserProperties.Add 方法來建立該屬性。 自訂檢視中不支援 PropertyAccessor 建立的自訂屬性。

您不能將自訂屬性新增到如 Word、Excel 或 PowerPoint 檔案的 Office 文件項目。 當您嘗試以程式設計方式將使用者定義的欄位新增至 DocumentItem 物件時,會收到錯誤。

範例

此 VBA 範例會建立新的 ContactItem 物件,並將 “LastDateSpokenWith” 新增為自訂屬性。

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

這個 VBA 範例會建立新的 ContactItem 物件並新增 "Details" 做為使用者屬性。 您可以變更 UserProperty 物件的 Value 屬性來設定這個值。

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

另請參閱

UserProperties 物件

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。