FrameworkPropertyMetadata.IsNotDataBindable Właściwość
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.
Pobiera lub ustawia wartość wskazującą, czy właściwość zależności obsługuje powiązanie danych.
public:
property bool IsNotDataBindable { bool get(); void set(bool value); };
public bool IsNotDataBindable { get; set; }
member this.IsNotDataBindable : bool with get, set
Public Property IsNotDataBindable As Boolean
Wartość właściwości
true
jeśli właściwość nie obsługuje powiązania danych; w przeciwnym razie , false
. Wartość domyślna to false
.
Wyjątki
Metadane zostały już zastosowane do operacji właściwości zależności, dzięki czemu metadane są zapieczętowane i nie można ustawić właściwości metadanych.
Uwagi
Należy pamiętać, że ta właściwość metadanych jest ustawiona specjalnie dla właściwości, które nie powinny obsługiwać true
powiązania danych, mimo że są właściwościami odczytu i zapisu. W większości przypadków, gdy właściwość zależności jest zadeklarowana, wymagane jest powiązanie danych, ponieważ powiązanie danych jest jednym z kluczowych scenariuszy, w których właściwość zależności jest przydatna. W przeciwieństwie do elementu nie powoduje to jedynie BindsTwoWayByDefaultzmiany wartości domyślnej, którą można później zmienić w określonym powiązaniu. Ustawienie tej właściwości true
w metadanych metadanych właściwości zależności spowoduje wyłączenie wszystkich powiązań z zastosowaniem ich wartości za pomocą wyrażeń do tej właściwości zależności.
Właściwości zależności tylko do odczytu nie obsługują powiązania danych (ponieważ nie mają ustawiania, które mogą stosować zmienione wartości), ale nadal będą raportować false
dla IsNotDataBindableelementu . Wynika to z tego, że właściwości, które odpowiadają FrameworkPropertyMetadataOptions wartościom, będą zgłaszać równoważność sposobu faktycznego ustanowienia metadanych, a nie zawsze zgłaszają zachowanie wyniku końcowego, które może oznaczać nazewnictwo właściwości. Aby określić, czy dana właściwość zależności zezwala na powiązanie danych, należy zwykle sprawdzić IsDataBindingAllowed zamiast tego.
IsDataBindingAllowed jest wygodą podczas sprawdzania zarówno operacji ReadOnly , jak i IsNotDataBindable jako pojedynczej operacji, dając oczekiwany wynik.
Właściwości klas pochodnych PropertyMetadata klasy są zwykle definiowane w modelu obiektów jako odczyt-zapis. Dzięki temu można je dostosować po zainicjowaniu wystąpienia. Jednak po użyciu metadanych w ramach wywołania metody Register, AddOwnerlub OverrideMetadatasystem właściwości przypieczętuje, że wystąpienie metadanych i właściwości przekazujące szczegóły metadanych są teraz uznawane za niezmienne. Próba ustawienia tej właściwości po IsSealed wystąpieniu true
tych metadanych spowoduje wystąpienie wyjątku.
Użycie tekstu w języku XAML
Składowe tej klasy nie są zwykle używane w języku XAML.