_PropertyAccessor.SetProperties(Object, Object) Метод

Определение

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

Microsoft.Office.Interop.Outlook

Сборка:

Microsoft.Office.Interop.Outlook.dll

Задает для свойств, заданных массивом SchemaNames , значения, заданные массивом Values.

public:
 System::Object ^ SetProperties(System::Object ^ SchemaNames, System::Object ^ Values);

public object SetProperties (object SchemaNames, object Values);

Public Function SetProperties (SchemaNames As Object, Values As Object) As Object

Параметры

SchemaNames

Object

Массив имен свойств, значения которых должны быть заданы в соответствии с параметром Values. На эти свойства ссылается пространство имен. Дополнительные сведения см. в разделе Ссылки на свойства по пространству имен.

Values

Object

Массив значений, которые необходимо задать для свойств, заданных параметром SchemaNames.

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

Object

Объект , имеющий значение Nothing (пустая ссылка (Nothing в Visual Basic) в C#), если операция выполнена успешно. Если возникла ошибка перед заданием каких-либо свойств, например, количество элементов в массиве SchemaNames не совпадает с числом элементов в массиве Values, и будет возвращено значение Err . Если при настройке свойств возникает ошибка, возвращаемое значение представляет собой массив объектов Err , количество элементов в этом массиве совпадает с числом элементов массива SchemaNames. Значение Err в массиве сопоставляется с результатом ошибки при задании соответствующего свойства в параметре SchemaNames.

Комментарии

Если свойство не существует и SchemaNames элемент содержит допустимый описатель свойства, setProperties создает свойство и присваивает свойству значение, заданное параметром Values. Тип свойства будет типом элемента, переданного в Values. Если свойство существует, setProperties присваивает свойству значение, указанное в параметре Values.

Обратите внимание, что пользовательское свойство, созданное с помощью PropertyAccessor , не поддерживается в пользовательском представлении. Если вы хотите просмотреть пользовательское свойство элемента, создайте свойство с помощью Add(String, OlUserPropertyType, Object, Object) метода .

Если родительский PropertyAccessor объект объекта поддерживает явную операцию сохранения , свойства должны быть сохранены в объекте с явным вызовом метода Save . Если объект не поддерживает явную операцию сохранения , свойства сохраняются в объекте при вызове SetProperties .

Будьте внимательны и убедитесь, что все исключения обрабатываются правильно. Ниже указаны условия, при которых не удается задать свойства:

Дополнительные сведения о настройке свойств с помощью объекта PropertyAccessor см. в разделе Рекомендации по получению и настройке свойств.