PropertyMetadata Constructeurs

Définition

Espace de noms:

System.Windows

Assembly:

WindowsBase.dll

Initialise une nouvelle instance de la classe PropertyMetadata.

Surcharges

PropertyMetadata()	Initialise une nouvelle instance de la classe PropertyMetadata.
PropertyMetadata(Object)	Initialise une nouvelle instance de la classe PropertyMetadata avec une valeur par défaut spécifiée pour la propriété de dépendance à laquelle ces métadonnées seront appliquées.
PropertyMetadata(PropertyChangedCallback)	Initialise une nouvelle instance de la classe PropertyMetadata avec la référence d'implémentation PropertyChangedCallback spécifiée.
PropertyMetadata(Object, PropertyChangedCallback)	Initialise une nouvelle instance de la classe PropertyMetadata avec la valeur par défaut et la référence d'implémentation PropertyChangedCallback spécifiées.
PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)	Initialise une nouvelle instance de la classe PropertyMetadata avec la valeur par défaut et les rappels spécifiés.

PropertyMetadata()

Initialise une nouvelle instance de la classe PropertyMetadata.

public:
 PropertyMetadata();

public PropertyMetadata ();

Public Sub New ()

PropertyMetadata(Object)

Initialise une nouvelle instance de la classe PropertyMetadata avec une valeur par défaut spécifiée pour la propriété de dépendance à laquelle ces métadonnées seront appliquées.

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

public PropertyMetadata (object defaultValue);

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

Public Sub New (defaultValue As Object)

Paramètres

defaultValue

Object

Valeur par défaut à spécifier pour une propriété de dépendance, habituellement fournie comme valeur d'un type spécifique.

Exceptions

ArgumentException

defaultValue ne peut pas avoir la valeur UnsetValue.

Exemples

static PropertyMetadata pm;

pm = new PropertyMetadata(Double.NaN);

Remarques

Le type de la valeur fournie pour defaultValue doit correspondre ou être lié au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées. Les incompatibilités entre le type de valeur par défaut des métadonnées et le type de la propriété de dépendance à laquelle elle est appliquée peuvent être difficiles à déboguer, car l’incompatibilité n’est pas détectable pendant la compilation (l’incompatibilité déclenche une exception d’exécution).

Bien qu’il s’agisse de la valeur par défaut du constructeur sans paramètre, un defaultValue de UnsetValue ne peut pas être spécifié. Si vous tentez de le faire, une exception est levée.

PropertyMetadata(PropertyChangedCallback)

Initialise une nouvelle instance de la classe PropertyMetadata avec la référence d'implémentation PropertyChangedCallback spécifiée.

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)

Paramètres

propertyChangedCallback

PropertyChangedCallback

Référence à l'implémentation d'un gestionnaire que le système de propriétés doit appeler à chaque fois que la valeur effective de la propriété change.

Exemples

static PropertyMetadata pm;

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

PropertyMetadata(Object, PropertyChangedCallback)

Initialise une nouvelle instance de la classe PropertyMetadata avec la valeur par défaut et la référence d'implémentation PropertyChangedCallback spécifiées.

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)

Paramètres

defaultValue

Object

Valeur par défaut de la propriété de dépendance, habituellement fournie comme valeur d'un type spécifique.

propertyChangedCallback

PropertyChangedCallback

Référence à l'implémentation d'un gestionnaire que le système de propriétés doit appeler à chaque fois que la valeur effective de la propriété change.

Exceptions

ArgumentException

defaultValue ne peut pas avoir la valeur UnsetValue.

Exemples

static PropertyMetadata pm;

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

Remarques

Le type de la valeur fournie defaultValue doit correspondre ou être lié au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées. Les incompatibilités entre le type de valeur par défaut des métadonnées et le type de la propriété de dépendance à laquelle elle est appliquée peuvent être difficiles à déboguer, car l’incompatibilité n’est pas détectable pendant la compilation (l’incompatibilité déclenche une exception d’exécution).

Bien qu’il s’agisse de la valeur par défaut du constructeur sans paramètre, un defaultValue de UnsetValue ne peut pas être spécifié. Si vous tentez de le faire, une exception est levée.

PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Initialise une nouvelle instance de la classe PropertyMetadata avec la valeur par défaut et les rappels spécifiés.

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)

Paramètres

defaultValue

Object

Valeur par défaut de la propriété de dépendance, habituellement fournie comme valeur d'un type spécifique.

propertyChangedCallback

PropertyChangedCallback

Référence à l'implémentation d'un gestionnaire que le système de propriétés doit appeler à chaque fois que la valeur effective de la propriété change.

coerceValueCallback

CoerceValueCallback

Référence à l'implémentation d'un gestionnaire qui doit être appelée à chaque fois que le système de propriétés appelle CoerceValue(DependencyProperty) à l'aide de cette propriété.

Exceptions

ArgumentException

defaultValue ne peut pas avoir la valeur UnsetValue.

Exemples

static PropertyMetadata pm;

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

Remarques

Si vous souhaitez spécifier un CoerceValueCallback , mais pas un PropertyChangedCallback, vous pouvez passer null pour le propertyChangedCallback paramètre .

Le type de la valeur fournie pour defaultValue doit correspondre ou être lié au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées. Les incompatibilités entre le type de valeur par défaut des métadonnées et le type de la propriété de dépendance à laquelle elle est appliquée peuvent être difficiles à déboguer, car l’incompatibilité n’est pas détectable pendant la compilation (l’incompatibilité déclenche une exception d’exécution).

Bien qu’il s’agisse de la valeur par défaut du constructeur sans paramètre, un defaultValue de UnsetValue ne peut pas être spécifié. Si vous tentez de le faire, une exception est levée.