PropertyMetadata Konstruktory

Definice

Obor názvů:

System.Windows

Sestavení:

WindowsBase.dll

Inicializuje novou instanci PropertyMetadata třídy.

Přetížení

PropertyMetadata()	Inicializuje novou instanci PropertyMetadata třídy.
PropertyMetadata(Object)	Inicializuje novou instanci PropertyMetadata třídy se zadanou výchozí hodnotou pro vlastnost závislosti, na kterou budou tato metadata použita.
PropertyMetadata(PropertyChangedCallback)	Inicializuje novou instanci PropertyMetadata třídy pomocí zadaného PropertyChangedCallback odkazu 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 ()

PropertyMetadata(Object)

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

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 určená pro vlastnost závislosti, která se obvykle poskytuje 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 musí defaultValue být shodný nebo musí souviset s typem zadaným v původní registraci vlastnosti závislosti, na kterou budou tato metadata použita. 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 neshodu nelze během kompilace zjistit (neshoda vyvolá výjimku za běhu).

I když je výchozí pro konstruktor bez parametrů, defaultValue nelze zadat hodnotu .UnsetValue Pokud se o to pokusíte, vyvolá se výjimka.

PropertyMetadata(PropertyChangedCallback)

Inicializuje novou instanci PropertyMetadata třídy pomocí zadaného PropertyChangedCallback odkazu 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ž se změní efektivní hodnota vlastnosti.

Příklady

static PropertyMetadata pm;

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

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, která se obvykle poskytuje 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ž se změní efektivní hodnota vlastnosti.

Výjimky

ArgumentException

defaultValue nelze nastavit na hodnotu UnsetValue.

Příklady

static PropertyMetadata pm;

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

Poznámky

Typ zadané defaultValue hodnoty se musí shodovat nebo musí souviset s typem zadaným v původní registraci vlastnosti závislosti, na kterou budou tato metadata použita. 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 neshodu nelze během kompilace zjistit (neshoda vyvolá výjimku za běhu).

I když je výchozí pro konstruktor bez parametrů, defaultValue nelze zadat hodnotu .UnsetValue Pokud se o to pokusíte, vyvolá se výjimka.

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, která se obvykle poskytuje 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ž se změní efektivní hodnota vlastnosti.

coerceValueCallback

CoerceValueCallback

Odkaz na implementaci obslužné rutiny, která má být volána vždy, když systém vlastností volá CoerceValue(DependencyProperty) tuto vlastnost.

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 parametr CoerceValueCallback , ale ne PropertyChangedCallback, můžete parametr propertyChangedCallback předatnull.

Typ zadané hodnoty musí defaultValue být shodný nebo musí souviset s typem zadaným v původní registraci vlastnosti závislosti, na kterou budou tato metadata použita. 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 neshodu nelze během kompilace zjistit (neshoda vyvolá výjimku za běhu).

I když je výchozí pro konstruktor bez parametrů, defaultValue nelze zadat hodnotu .UnsetValue Pokud se o to pokusíte, vyvolá se výjimka.