DependencyObject.SetValue(DependencyProperty, Object) 方法

定义

设置 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)

参数

dp
DependencyProperty

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

value
Object

Platform::Object

IInspectable

新的本地值。

注解

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

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

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

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

适用于

另请参阅