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)

要设置的依赖属性的标识符。

新的本地值。

如果提供的值类型与最初注册时为依赖属性声明的类型不匹配，则会引发异常。

并非 XAML 使用的所有Windows 运行时属性都是依赖属性。 DependencyProperty 标识符需要存在，并且它必须作为拥有对象（通常是注册该属性的对象）的公共属性提供。

对于应用用户代码，通常不需要调用 SetValue。通常，Windows 运行时依赖属性或自定义依赖属性具有包装它的传统属性，你可以通过传统的虚线用法来设置属性值。可能仍使用 SetValue 的情况包括：

你正在定义一个自定义依赖属性。在为传统属性用法定义自己的属性集访问器时，将调用 SetValue。有关详细信息，请参阅自定义的依赖属性。
你正在定义一个回调，或者位于已向其传递 DependencyProperty 标识符的其他某个范围中，并且可能存在多个你可能希望在该范围内与之交互的依赖属性。在这些情况下，调用 SetValue 传递标识符可能更简单。