_PropertyAccessor.SetProperties(Object, Object) 方法

定义

将数组 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 参数指定的属性设置的值的数组。

返回

如果操作成功,则为 Nothing (空引用 (Visual Basic) C# ) 中没有任何对象。 如果之前设置任何属性时出现错误,例如, SchemaNames数组中元素的个数不匹配,在 Values数组中,并将返回 Err 值。 如果在属性的设置时出现错误,返回值是 Err 对象,正在与 SchemaNames数组的相同此数组中的元素数的数组。 数组中的 错误 值被映射到在 SchemaNames参数中设置相应的属性的错误结果。

注解

如果该属性不存在, SchemaNames 并且元素包含有效的属性说明符,则 SetProperties 将创建 属性,并使用 指定的 Values值分配属性。 属性的类型将是 传入 Values的元素的类型。 如果该属性确实存在,则 SetProperties 为属性分配指定的 Values值。

请注意,使用 PropertyAccessor 创建的自定义属性在自定义视图中不受支持。 如果要查看项上的自定义属性,请使用 Add(String, OlUserPropertyType, Object, Object) 方法创建属性。

如果 的 PropertyAccessor 父对象支持显式 Save 操作,则应使用显式 Save 方法调用将属性保存到 对象。 如果该对象不支持显式 Save 操作,则属性保存到该对象在调用 SetProperties 时。

处理异常时要多加小心,并确保所有异常都已正确处理。 设置属性失败的情况包括:

有关使用 PropertyAccessor 对象设置属性的详细信息,请参阅 获取和设置属性的最佳做法

适用于