UserProperties.Add(String, OlUserPropertyType, Object, Object) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在集合中 UserProperties 创建新的用户属性。
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
参数
- Name
- String
属性的名称。 最大长度为 64 个字符。 字符,[,],名称中不允许 _ 和 #。
- Type
- OlUserPropertyType
新属性的类型。
- AddToFolderFields
- Object
如此 如果将属性作为自定义字段添加到项目所在的文件夹。 可以在文件夹视图中显示此字段。 假 如果属性将作为自定义字段添加,于该项而不适用于文件夹。 默认值为 True。
- DisplayFormat
- Object
指定该属性在 Outlook 用户界面中的显示方式。 此参数可以设置为多个不同枚举中的一个值,这些枚举由 参数中指定的 Type
属性类型确定。 有关 和 交互方式Type
的详细信息,请参阅 DisplayFormat。DisplayFormat
返回
一个 UserProperty 表示新属性的 对象。
注解
可以通过调用 Outlook 项目或文件夹的 UserProperties.Add 方法或 Add(String, OlUserPropertyType, Object, Object) 文件夹的 方法来定义自定义属性。
可以创建枚举 OlUserPropertyType 定义的类型的属性,但以下类型除外: olEnumeration、 olOutlookInternal和 olSmartFrom。
若要首次设置 由 Add 方法创建的属性,请使用 Value 对象的 属性 UserProperty ,而不是 SetProperties(Object, Object) 对象的 或 SetProperty(String, Object) 方法 PropertyAccessor 。
如果您想要查看的项的自定义属性,您必须使用 UserProperties.Add 方法来创建该属性。 自定义视图中不支持由 PropertyAccessor 创建的自定义属性。
不能将自定义属性添加到 Office 文档项目,例如 Word、Excel 或 PowerPoint 文件。 尝试以编程方式将用户定义的字段添加到 DocumentItem 对象时,将收到错误。