FrameworkPropertyMetadata.IsNotDataBindable Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows
Zestaw:
PresentationFramework.dll

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

Boolean

true jeśli właściwość nie obsługuje powiązania danych; w przeciwnym razie , false. Wartość domyślna to false.

Wyjątki

InvalidOperationException

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.

Dotyczy

Zobacz też