Freigeben über


PropertyMetadata Konstruktoren

Definition

Initialisiert eine neue Instanz der PropertyMetadata-Klasse.

Überlädt

PropertyMetadata()

Initialisiert eine neue Instanz der PropertyMetadata-Klasse.

PropertyMetadata(Object)

Initialisiert eine neue Instanz der PropertyMetadata-Klasse mit einem angegebenen Standardwert für die Abhängigkeitseigenschaft, auf die diese Metadaten angewendet werden.

PropertyMetadata(PropertyChangedCallback)

Initialisiert eine neue Instanz der PropertyMetadata-Klasse mit dem angegebenen PropertyChangedCallback-Implementierungsverweis.

PropertyMetadata(Object, PropertyChangedCallback)

Initialisiert eine neue Instanz der PropertyMetadata-Klasse mit dem angegebenen Standardwert und dem angegebenen PropertyChangedCallback-Implementierungsverweis.

PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Initialisiert eine neue Instanz der PropertyMetadata-Klasse mit dem angegebenen Standardwert und den angegebenen Rückrufen.

PropertyMetadata()

Initialisiert eine neue Instanz der PropertyMetadata-Klasse.

public:
 PropertyMetadata();
public PropertyMetadata ();
Public Sub New ()

Gilt für:

PropertyMetadata(Object)

Initialisiert eine neue Instanz der PropertyMetadata-Klasse mit einem angegebenen Standardwert für die Abhängigkeitseigenschaft, auf die diese Metadaten angewendet werden.

public:
 PropertyMetadata(System::Object ^ defaultValue);
public PropertyMetadata (object defaultValue);
new System.Windows.PropertyMetadata : obj -> System.Windows.PropertyMetadata
Public Sub New (defaultValue As Object)

Parameter

defaultValue
Object

Der anzugebende Standardwert für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.

Ausnahmen

defaultValue kann nicht auf den Wert UnsetValue festgelegt werden.

Beispiele

static PropertyMetadata pm;
pm = new PropertyMetadata(Double.NaN);

Hinweise

Der Typ des für defaultValue bereitgestellten Werts muss mit dem Typ übereinstimmen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben wurde, auf die diese Metadaten angewendet werden. Konflikte zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet werden, können schwierig zu debuggen sein, da der Konflikt während der Kompilierung nicht erkennbar ist (der Konflikt löst eine Laufzeit-Ausnahme aus).

Obwohl es sich um die Standardeinstellung für den parameterlosen Konstruktor handelt, kann ein defaultValue von UnsetValue nicht angegeben werden. Wenn Sie dies versuchen, wird eine Ausnahme ausgelöst.

Gilt für:

PropertyMetadata(PropertyChangedCallback)

Initialisiert eine neue Instanz der PropertyMetadata-Klasse mit dem angegebenen PropertyChangedCallback-Implementierungsverweis.

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)

Parameter

propertyChangedCallback
PropertyChangedCallback

Verweis auf eine Handlerimplementierung, die vom Eigenschaftensystem aufgerufen werden muss, wenn der effektive Wert der Eigenschaft geändert wird.

Beispiele

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

Gilt für:

PropertyMetadata(Object, PropertyChangedCallback)

Initialisiert eine neue Instanz der PropertyMetadata-Klasse mit dem angegebenen Standardwert und dem angegebenen PropertyChangedCallback-Implementierungsverweis.

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)

Parameter

defaultValue
Object

Der Standardwert für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.

propertyChangedCallback
PropertyChangedCallback

Verweis auf eine Handlerimplementierung, die vom Eigenschaftensystem aufgerufen werden muss, wenn der effektive Wert der Eigenschaft geändert wird.

Ausnahmen

defaultValue kann nicht auf den Wert UnsetValue festgelegt werden.

Beispiele

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

Hinweise

Der Typ des angegebenen defaultValue Werts muss mit dem Typ übereinstimmen oder mit dem typ verknüpft sein, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben wurde, auf die diese Metadaten angewendet werden. Konflikte zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet werden, können schwierig zu debuggen sein, da der Konflikt während der Kompilierung nicht erkennbar ist (der Konflikt löst eine Laufzeit-Ausnahme aus).

Obwohl es sich um die Standardeinstellung für den parameterlosen Konstruktor handelt, kann ein defaultValue von UnsetValue nicht angegeben werden. Wenn Sie dies versuchen, wird eine Ausnahme ausgelöst.

Gilt für:

PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Initialisiert eine neue Instanz der PropertyMetadata-Klasse mit dem angegebenen Standardwert und den angegebenen Rückrufen.

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)

Parameter

defaultValue
Object

Der Standardwert für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.

propertyChangedCallback
PropertyChangedCallback

Verweis auf eine Handlerimplementierung, die vom Eigenschaftensystem aufgerufen werden muss, wenn der effektive Wert der Eigenschaft geändert wird.

coerceValueCallback
CoerceValueCallback

Verweis auf eine Handlerimplementierung, die aufgerufen werden muss, wenn das Eigenschaftensystem CoerceValue(DependencyProperty) für diese Eigenschaft aufruft.

Ausnahmen

defaultValue kann nicht auf den Wert UnsetValue festgelegt werden.

Beispiele

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

Hinweise

Wenn Sie einenCoerceValueCallback, aber keinen PropertyChangedCallbackangeben möchten, können Sie für den propertyChangedCallback -Parameter übergebennull.

Der Typ des für defaultValue bereitgestellten Werts muss mit dem Typ übereinstimmen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben wurde, auf die diese Metadaten angewendet werden. Konflikte zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet werden, können schwierig zu debuggen sein, da der Konflikt während der Kompilierung nicht erkennbar ist (der Konflikt löst eine Laufzeit-Ausnahme aus).

Obwohl es sich um die Standardeinstellung für den parameterlosen Konstruktor handelt, kann ein defaultValue von UnsetValue nicht angegeben werden. Wenn Sie dies versuchen, wird eine Ausnahme ausgelöst.

Gilt für: