DependencyObject.SetValue(DependencyProperty, Object) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
设置 DependencyObject 上依赖属性的本地值。
public:
virtual void SetValue(DependencyProperty ^ dp, Platform::Object ^ value) = SetValue;
void SetValue(DependencyProperty const& dp, IInspectable const& value);
public void SetValue(DependencyProperty dp, object value);
function setValue(dp, value)
Public Sub SetValue (dp As DependencyProperty, value As Object)
参数
要设置的依赖属性的标识符。
- value
-
Object
Platform::Object
IInspectable
新的本地值。
注解
如果提供 的值 类型与最初注册的依赖属性声明的类型不匹配,则会引发异常。
并非 XAML 使用的所有Windows 运行时属性都是依赖属性。 DependencyProperty 标识符需要存在,并且它必须作为拥有对象(通常是注册该属性的对象)的公共属性提供。
对于应用用户代码,通常不需要调用 SetValue
。 通常,Windows 运行时依赖属性或自定义依赖属性具有包装它的常规属性,只需通过传统的虚点用法来设置属性值。 可能仍使用 SetValue
的情况包括:
- 你正在定义一个自定义依赖属性。 在为传统属性用法定义自己的属性集访问器时,将调用
SetValue
。 有关详细信息,请参阅自定义的依赖属性。 - 你正在定义回调或位于某个其他范围内,其中已传递 DependencyProperty 标识符,并且可能存在多个依赖属性,你可能想要在该范围内与之交互。 在这些情况下,调用
SetValue
传递标识符可能更简单。