PropertyMetadata Konstruktory
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Inicjuje nowe wystąpienie klasy PropertyMetadata.
Przeciążenia
PropertyMetadata() |
Inicjuje nowe wystąpienie klasy PropertyMetadata. |
PropertyMetadata(Object) |
Inicjuje PropertyMetadata nowe wystąpienie klasy z określoną wartością domyślną właściwości zależności, do której zostaną zastosowane te metadane. |
PropertyMetadata(PropertyChangedCallback) |
Inicjuje PropertyMetadata nowe wystąpienie klasy przy użyciu określonego PropertyChangedCallback odwołania do implementacji. |
PropertyMetadata(Object, PropertyChangedCallback) |
Inicjuje PropertyMetadata nowe wystąpienie klasy z określoną wartością domyślną i PropertyChangedCallback odwołaniem do implementacji. |
PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback) |
Inicjuje PropertyMetadata nowe wystąpienie klasy z określoną wartością domyślną i wywołaniami zwrotnymi. |
PropertyMetadata()
Inicjuje nowe wystąpienie klasy PropertyMetadata.
public:
PropertyMetadata();
public PropertyMetadata ();
Public Sub New ()
Dotyczy
PropertyMetadata(Object)
Inicjuje PropertyMetadata nowe wystąpienie klasy z określoną wartością domyślną właściwości zależności, do której zostaną zastosowane te metadane.
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
Wartość domyślna określająca właściwość zależności, zwykle podana jako wartość określonego typu.
Wyjątki
defaultValue
nie można ustawić wartości UnsetValue.
Przykłady
static PropertyMetadata pm;
pm = new PropertyMetadata(Double.NaN);
Uwagi
Typ podanej defaultValue
wartości musi być zgodny lub powiązany z typem określonym w oryginalnej rejestracji właściwości zależności, do której zostaną zastosowane te metadane. Niezgodność między typem wartości domyślnej metadanych a typem właściwości zależności, do której jest stosowany, może być trudna do debugowania, ponieważ niezgodność nie jest wykrywana podczas kompilacji (niezgodność zgłosi wyjątek czasu wykonywania).
Chociaż jest to wartość domyślna dla konstruktora bez parametrów, defaultValue
nie można określić wartości UnsetValue . Próba wykonania tej czynności spowoduje wystąpienie wyjątku.
Dotyczy
PropertyMetadata(PropertyChangedCallback)
Inicjuje PropertyMetadata nowe wystąpienie klasy przy użyciu określonego PropertyChangedCallback odwołania do implementacji.
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
Odwołanie do implementacji procedury obsługi, która ma być wywoływana przez system właściwości za każdym razem, gdy obowiązująca wartość właściwości się zmienia.
Przykłady
static PropertyMetadata pm;
pm = new PropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));
Dotyczy
PropertyMetadata(Object, PropertyChangedCallback)
Inicjuje PropertyMetadata nowe wystąpienie klasy z określoną wartością domyślną i PropertyChangedCallback odwołaniem do implementacji.
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
Wartość domyślna właściwości zależności, zwykle podana jako wartość określonego typu.
- propertyChangedCallback
- PropertyChangedCallback
Odwołanie do implementacji procedury obsługi, która ma być wywoływana przez system właściwości za każdym razem, gdy obowiązująca wartość właściwości się zmienia.
Wyjątki
defaultValue
nie można ustawić wartości UnsetValue.
Przykłady
static PropertyMetadata pm;
pm = new PropertyMetadata(
Double.NaN,
new PropertyChangedCallback(OnCurrentReadingChanged)
);
Uwagi
Typ podanej defaultValue
wartości musi być zgodny lub powiązany z typem określonym w oryginalnej rejestracji właściwości zależności, do której zostaną zastosowane te metadane. Niezgodność między typem wartości domyślnej metadanych a typem właściwości zależności, do której jest stosowany, może być trudna do debugowania, ponieważ niezgodność nie jest wykrywana podczas kompilacji (niezgodność zgłosi wyjątek czasu wykonywania).
Chociaż jest to wartość domyślna dla konstruktora bez parametrów, defaultValue
nie można określić wartości UnsetValue . Próba wykonania tej czynności spowoduje wystąpienie wyjątku.
Dotyczy
PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)
Inicjuje PropertyMetadata nowe wystąpienie klasy z określoną wartością domyślną i wywołaniami zwrotnymi.
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
Wartość domyślna właściwości zależności, zwykle podana jako wartość określonego typu.
- propertyChangedCallback
- PropertyChangedCallback
Odwołanie do implementacji procedury obsługi, która ma być wywoływana przez system właściwości za każdym razem, gdy obowiązująca wartość właściwości się zmienia.
- coerceValueCallback
- CoerceValueCallback
Odwołanie do implementacji procedury obsługi, która ma być wywoływana za każdym razem, gdy system właściwości wywołuje CoerceValue(DependencyProperty) tę właściwość.
Wyjątki
defaultValue
nie można ustawić wartości UnsetValue.
Przykłady
static PropertyMetadata pm;
pm = new PropertyMetadata(
Double.NaN,
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
Uwagi
Jeśli chcesz określić parametr CoerceValueCallback , ale nie PropertyChangedCallback, możesz przekazać null
parametr propertyChangedCallback
.
Typ podanej defaultValue
wartości musi być zgodny lub powiązany z typem określonym w oryginalnej rejestracji właściwości zależności, do której zostaną zastosowane te metadane. Niezgodność między typem wartości domyślnej metadanych a typem właściwości zależności, do której jest stosowany, może być trudna do debugowania, ponieważ niezgodność nie jest wykrywana podczas kompilacji (niezgodność zgłosi wyjątek czasu wykonywania).
Chociaż jest to wartość domyślna dla konstruktora bez parametrów, defaultValue
nie można określić wartości UnsetValue . Próba wykonania tej czynności spowoduje wystąpienie wyjątku.