PropertyMetadata 构造函数

定义

命名空间:

System.Windows

程序集:

WindowsBase.dll

初始化 PropertyMetadata 类的新实例。

重载

PropertyMetadata()	初始化 PropertyMetadata 类的新实例。
PropertyMetadata(Object)	使用此元数据将应用于的依赖项对象的指定默认值，初始化 PropertyMetadata 类的新实例。
PropertyMetadata(PropertyChangedCallback)	用指定的 PropertyMetadata 实现引用初始化 PropertyChangedCallback 类的新实例。
PropertyMetadata(Object, PropertyChangedCallback)	用指定的默认值和 PropertyMetadata 实现引用初始化 PropertyChangedCallback 类的新实例。
PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)	用指定的默认值和回调初始化 PropertyMetadata 类的新实例。

PropertyMetadata()

初始化 PropertyMetadata 类的新实例。

public:
 PropertyMetadata();

public PropertyMetadata ();

Public Sub New ()

PropertyMetadata(Object)

使用此元数据将应用于的依赖项对象的指定默认值，初始化 PropertyMetadata 类的新实例。

public:
 PropertyMetadata(System::Object ^ defaultValue);

public PropertyMetadata (object defaultValue);

new System.Windows.PropertyMetadata : obj -> System.Windows.PropertyMetadata

Public Sub New (defaultValue As Object)

参数

defaultValue

Object

要为依赖项对象指定的默认值，通常作为某种特定类型的值提供。

例外

ArgumentException

defaultValue 不能设置为值 UnsetValue。

示例

static PropertyMetadata pm;

pm = new PropertyMetadata(Double.NaN);

注解

为 defaultValue 提供的值的类型必须与此元数据将应用到的依赖属性的原始注册中指定的类型匹配或相关。 元数据默认值类型与应用它的依赖属性类型之间的不匹配可能难以调试，因为在编译期间无法检测到不匹配， (不匹配将引发运行时异常) 。

尽管它是无参数构造函数的默认值， defaultValue 但不能指定 的 UnsetValue 。 尝试这样做将引发异常。

PropertyMetadata(PropertyChangedCallback)

用指定的 PropertyMetadata 实现引用初始化 PropertyChangedCallback 类的新实例。

public:
 PropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public PropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.PropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.PropertyMetadata

Public Sub New (propertyChangedCallback As PropertyChangedCallback)

参数

propertyChangedCallback

PropertyChangedCallback

对处理程序实现的引用，每当属性的有效值更改时，属性系统都将调用该处理程序实现。

示例

static PropertyMetadata pm;

pm = new PropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));

PropertyMetadata(Object, PropertyChangedCallback)

用指定的默认值和 PropertyMetadata 实现引用初始化 PropertyChangedCallback 类的新实例。

public:
 PropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public PropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.PropertyMetadata : obj * System.Windows.PropertyChangedCallback -> System.Windows.PropertyMetadata

Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)

参数

defaultValue

Object

依赖项对象的默认值，通常作为某种特定类型的值提供。

propertyChangedCallback

PropertyChangedCallback

对处理程序实现的引用，每当属性的有效值更改时，属性系统都将调用该处理程序实现。

例外

ArgumentException

defaultValue 不能设置为值 UnsetValue。

示例

static PropertyMetadata pm;

pm = new PropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

注解

提供 defaultValue 的值的类型必须与此元数据将应用到的依赖属性的原始注册中指定的类型匹配或相关。 元数据默认值类型与应用它的依赖属性类型之间的不匹配可能难以调试，因为在编译期间无法检测到不匹配， (不匹配将引发运行时异常) 。

尽管它是无参数构造函数的默认值， defaultValue 但不能指定 的 UnsetValue 。 尝试这样做将引发异常。

PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

用指定的默认值和回调初始化 PropertyMetadata 类的新实例。

public:
 PropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);

public PropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);

new System.Windows.PropertyMetadata : obj * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.PropertyMetadata

Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

参数

defaultValue

Object

依赖项对象的默认值，通常作为某种特定类型的值提供。

propertyChangedCallback

PropertyChangedCallback

对处理程序实现的引用，每当属性的有效值更改时，属性系统都将调用该处理程序实现。

coerceValueCallback

CoerceValueCallback

对处理程序实现的引用，每当属性系统对该属性调用 CoerceValue(DependencyProperty) 时都将调用此处理程序实现。

例外

ArgumentException

defaultValue 不能设置为值 UnsetValue。

示例

static PropertyMetadata pm;

pm = new PropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

注解

如果要指定 ，但不能指定 CoerceValueCallback ，可以为 参数传递 nullpropertyChangedCallback 。PropertyChangedCallback

为 defaultValue 提供的值的类型必须与此元数据将应用到的依赖属性的原始注册中指定的类型匹配或相关。 元数据默认值类型与应用它的依赖属性类型之间的不匹配可能难以调试，因为在编译期间无法检测到不匹配， (不匹配将引发运行时异常) 。

尽管它是无参数构造函数的默认值， defaultValue 但不能指定 的 UnsetValue 。 尝试这样做将引发异常。