PropertyMetadata Konstruktory

Definice

Obor názvů:: System.Windows

Sestavení:: WindowsBase.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Inicializuje novou instanci PropertyMetadata třídy.

Přetížení

Name	Description
PropertyMetadata()	Inicializuje novou instanci PropertyMetadata třídy.
PropertyMetadata(Object)	Inicializuje novou instanci PropertyMetadata třídy se zadanou výchozí hodnotou vlastnosti závislosti, na kterou se tato metadata použijí.
PropertyMetadata(PropertyChangedCallback)	Inicializuje novou instanci PropertyMetadata třídy se zadaným PropertyChangedCallback odkazem na implementaci.
PropertyMetadata(Object, PropertyChangedCallback)	Inicializuje novou instanci PropertyMetadata třídy se zadanou výchozí hodnotou a PropertyChangedCallback odkazem na implementaci.
PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)	Inicializuje novou instanci PropertyMetadata třídy se zadanou výchozí hodnotou a zpětnými voláními.

PropertyMetadata()

Inicializuje novou instanci PropertyMetadata třídy.

public:
 PropertyMetadata();

public PropertyMetadata();

Public Sub New ()

Platí pro

PropertyMetadata(Object)

Inicializuje novou instanci PropertyMetadata třídy se zadanou výchozí hodnotou vlastnosti závislosti, na kterou se tato metadata použijí.

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

public PropertyMetadata(object defaultValue);

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

Public Sub New (defaultValue As Object)

Parametry

defaultValue: Object

Výchozí hodnota, která se má zadat pro vlastnost závislosti, obvykle zadaná jako hodnota určitého typu.

Výjimky

ArgumentException

defaultValue nelze nastavit na hodnotu UnsetValue.

Příklady

static PropertyMetadata pm;

pm = new PropertyMetadata(Double.NaN);

Poznámky

Typ zadané hodnoty defaultValue musí být shodný nebo musí souviset s typem zadaným v původní registraci vlastnosti závislosti, na kterou se tato metadata použijí. Neshody mezi výchozím typem hodnoty metadat a typem vlastnosti závislosti, na kterou se používá, může být obtížné ladit, protože neshoda není během kompilace zjistitelná (neshoda vyvolá výjimku za běhu).

I když se jedná o výchozí hodnotu pro konstruktor bez parametrů, defaultValue nelze zadat hodnotu.UnsetValue Pokus o to vyvolá výjimku.

Platí pro

PropertyMetadata(PropertyChangedCallback)

Inicializuje novou instanci PropertyMetadata třídy se zadaným PropertyChangedCallback odkazem na implementaci.

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)

Parametry

propertyChangedCallback: PropertyChangedCallback

Odkaz na implementaci obslužné rutiny, která má být volána systémem vlastností vždy, když efektivní hodnota vlastnosti se změní.

Příklady

static PropertyMetadata pm;

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

Platí pro

PropertyMetadata(Object, PropertyChangedCallback)

Inicializuje novou instanci PropertyMetadata třídy se zadanou výchozí hodnotou a PropertyChangedCallback odkazem na implementaci.

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)

Parametry

defaultValue: Object

Výchozí hodnota vlastnosti závislosti, obvykle zadaná jako hodnota určitého typu.

propertyChangedCallback: PropertyChangedCallback

Odkaz na implementaci obslužné rutiny, která má být volána systémem vlastností vždy, když efektivní hodnota vlastnosti se změní.

Výjimky

ArgumentException

defaultValue nelze nastavit na hodnotu UnsetValue.

Příklady

static PropertyMetadata pm;

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

Poznámky

Zadaný typ hodnoty defaultValue se musí shodovat nebo musí souviset s typem zadaným v původní registraci vlastnosti závislosti, na kterou se tato metadata použijí. Neshody mezi výchozím typem hodnoty metadat a typem vlastnosti závislosti, na kterou se používá, může být obtížné ladit, protože neshoda není během kompilace zjistitelná (neshoda vyvolá výjimku za běhu).

I když se jedná o výchozí hodnotu pro konstruktor bez parametrů, defaultValue nelze zadat hodnotu.UnsetValue Pokus o to vyvolá výjimku.

Platí pro

PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Inicializuje novou instanci PropertyMetadata třídy se zadanou výchozí hodnotou a zpětnými voláními.

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)

Parametry

defaultValue: Object

Výchozí hodnota vlastnosti závislosti, obvykle zadaná jako hodnota určitého typu.

propertyChangedCallback: PropertyChangedCallback

Odkaz na implementaci obslužné rutiny, která má být volána systémem vlastností vždy, když efektivní hodnota vlastnosti se změní.

coerceValueCallback: CoerceValueCallback

Odkaz na implementaci obslužné rutiny, která se má volat při každém volání CoerceValue(DependencyProperty) systému vlastností proti této vlastnosti.

Výjimky

ArgumentException

defaultValue nelze nastavit na hodnotu UnsetValue.

Příklady

static PropertyMetadata pm;

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

Poznámky

Pokud chcete zadat parametrCoerceValueCallback, ale ne PropertyChangedCallback, můžete parametr null předatpropertyChangedCallback.

I když se jedná o výchozí hodnotu pro konstruktor bez parametrů, defaultValue nelze zadat hodnotu.UnsetValue Pokus o to vyvolá výjimku.

Platí pro

Váš názor

Byla tato stránka užitečná?