FrameworkPropertyMetadata.IsNotDataBindable Vlastnost
Definice
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í.
Získá nebo nastaví hodnotu, která označuje, zda vlastnost závislost podporuje datové vazby.
public:
property bool IsNotDataBindable { bool get(); void set(bool value); };public bool IsNotDataBindable { get; set; }member this.IsNotDataBindable : bool with get, setPublic Property IsNotDataBindable As BooleanHodnota vlastnosti
true pokud vlastnost nepodporuje datová vazba; falsev opačném případě . Výchozí formát je false.
Výjimky
Metadata již byla použita pro operaci vlastnosti závislosti, takže metadata jsou zapečetěna a vlastnosti metadat nelze nastavit.
Poznámky
Všimněte si, že tato vlastnost metadat je nastavena speciálně true pro vlastnosti, které by neměly podporovat datovou vazbu, navzdory tomu, že vlastnosti pro čtení i zápis. Očekává se, že ve většině případů, kdy je deklarována vlastnost závislosti, je požadovaná datová vazba, protože datová vazba je jedním z klíčových scénářů, kdy je vlastnost závislostí užitečná. Na rozdíl od BindsTwoWayByDefaulttoho se nezmění pouze výchozí nastavení, které lze později změnit u konkrétní vazby. Nastavení této vlastnosti true v metadatech vlastností závislostí zakáže, aby všechny vazby použily své hodnoty prostřednictvím výrazů na tuto vlastnost závislostí.
Vlastnosti závislostí jen pro čtení nepodporují datovou vazbu (protože nemají žádné setter, které by mohly použít změněné hodnoty), ale přesto budou sestavovat false pro IsNotDataBindable. Důvodem je to, že vlastnosti, které odpovídají hodnotám FrameworkPropertyMetadataOptions , budou hlásit paritu s tím, jak byla metadata skutečně vytvořena, a ne vždy hlásí chování koncového výsledku, které by mohlo znamenat pojmenování vlastnosti. Pokud chcete zjistit, jestli daná vlastnost závislostí povoluje datovou vazbu, měli byste místo toho obvykle zkontrolovat IsDataBindingAllowed . IsDataBindingAllowed je pohodlná kontrola jak ReadOnly jedné operace, tak IsNotDataBindable jako jedna operace, což vede k očekávanému výsledku.
Vlastnosti odvozených tříd PropertyMetadata jsou obvykle definovány v objektovém modelu jako čtení-zápis. To znamená, že je možné je upravit po inicializaci instance. Jakmile se však metadata spotřebují jako součást volání Register, AddOwnernebo OverrideMetadata, systém vlastností zapečetí, že instance metadat a vlastnosti, které vyjadřují specifika metadat, jsou nyní považovány za neměnné. Při pokusu o nastavení této vlastnosti v IsSealed true této instanci metadat dojde k výjimce.
Použití textu XAML
Členové této třídy se obvykle nepoužívají v JAZYCE XAML.