UserProperties.Add(String, OlUserPropertyType, Object, Object) Метод

Определение

Пространство имен:

Microsoft.Office.Interop.Outlook

Сборка:

Microsoft.Office.Interop.Outlook.dll

Создает новое свойство пользователя в 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 , если свойство будет добавлено в качестве настраиваемого поля в папку, в которую находится элемент. Это поле может отображаться в представлении папки. False , если свойство будет добавлено в качестве настраиваемого поля в элемент, но не в папку. Значение по умолчанию — True.

DisplayFormat

Object

Указывает, как свойство будет отображаться в пользовательском интерфейсе Outlook. Для этого параметра можно задать значение из одного из нескольких различных перечислений, определяемое типом свойства, указанным в параметре Type . Дополнительные сведения о взаимодействии Type и DisplayFormat взаимодействии см. в разделе DisplayFormat.

Возвращаемое значение

UserProperty

Объект UserProperty , представляющий новое свойство.

Комментарии

Пользовательские свойства можно определить, вызвав метод UserProperties.Add для элемента Или папки Outlook или Add(String, OlUserPropertyType, Object, Object) метод для папки.

Можно создать свойство типа, определенного перечислением OlUserPropertyType , за исключением следующих типов: olEnumeration, olOutlookInternalи olSmartFrom.

Чтобы впервые задать свойство, созданное методом Add, используйте Value свойство UserProperty объекта вместо SetProperties(Object, Object) метода PropertyAccessor или SetProperty(String, Object) объекта .

Если вы хотите просмотреть пользовательское свойство элемента, необходимо использовать метод UserProperties.Add для создания этого свойства. Пользовательские свойства, созданные с PropertyAccessor помощью , не поддерживаются в пользовательском представлении.

Вы не можете добавлять настраиваемые свойства в элементы документов Office, такие как Word, Excel или файлы PowerPoint. При попытке программного добавления определяемого пользователем поля в объект появится сообщение об ошибке DocumentItem .