Binding Třída

Reference

Definice

Obor názvů:: System.Windows.Data

Sestavení:: PresentationFramework.dll

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í.

Poskytuje přístup vysoké úrovně k definici vazby, která spojuje vlastnosti cílových objektů vazby (obvykle prvky WPF) a libovolného zdroje dat (například databáze, soubor XML nebo jakýkoli objekt, který obsahuje data).

public ref class Binding : System::Windows::Data::BindingBase

public class Binding : System.Windows.Data.BindingBase

type Binding = class
    inherit BindingBase

Public Class Binding
Inherits BindingBase

Dědičnost: Object

MarkupExtension

BindingBase
Binding

Poznámky

Datová vazba WPF (Windows Presentation Foundation) je jednoduchý a konzistentní způsob, jakým aplikace můžou zobrazovat data a pracovat s nimi. Datová vazba umožňuje synchronizovat hodnoty vlastností dvou různých objektů.

Chcete-li vytvořit vazbu, použijte Binding třídu nebo jednu z dalších tříd, které dědí BindingBase. Bez ohledu na to, jaký objekt vytváříte vazbu a povahu zdroje dat, každá vazba se řídí modelem znázorněným na následujícím obrázku.

Základní diagram datových vazeb

Obrázek znázorňuje následující základní koncepty datových vazeb WPF.

Každá vazba má obvykle tyto čtyři komponenty: objekt cíle vazby, vlastnost cíle, zdroj vazby a Path hodnotu ve zdroji vazby, která se má použít. Pokud například chcete svázat obsah TextBox objektu s vlastností Name objektu Employee, je TextBoxcílovým objektem , vlastnost cíle je Text vlastnost , použitá hodnota je Name a zdrojovým objektem je zaměstnanec.
Vlastnost cíle musí být vlastnost závislosti. To také znamená, že nemůžete vytvořit vazbu mezi polem. Většina vlastností UIElement objektů jsou vlastnosti závislostí a většina vlastností závislostí, s výjimkou těch jen pro čtení, podporuje datové vazby ve výchozím nastavení. (Pouze DependencyObject typy mohou definovat vlastnosti závislostí a všechny UIElement objekty jsou odvozeny z DependencyObject.)
I když není na obrázku zadán, je třeba poznamenat, že objekt zdroje vazby není omezen na vlastní objekt CLR. Datová vazba WPF podporuje data ve formě objektů CLR a XML. Chcete-li uvést několik příkladů, zdrojem vazby může být UIElementobjekt , libovolný objekt seznamu, objekt CLR, který je přidružen k ADO.NET dat nebo webových služeb, nebo XmlNode, který obsahuje data XML.

Mode Pomocí vlastnosti určete směr toku dat. Pokud chcete detekovat změny zdroje v jednosměrných nebo obousměrných vazbách, musí zdroj implementovat vhodný mechanismus oznamování změn vlastností, například INotifyPropertyChanged. Příklad najdete v tématu Postupy: Implementace oznámení o změně vlastností. Vlastnost UpdateSourceTrigger určuje načasování aktualizací zdroje. Další informace najdete v tématu Základní koncepty datových vazeb v přehledu datových vazeb.

Použití atributu XAML

<object property="{Binding  declaration}"/>

Hodnoty XAML

Prohlášení
Nula nebo více klauzulí přiřazení atributů oddělených čárkami (,). Další informace najdete v tématu Rozšíření značek vazby nebo Přehled deklarací vazeb.

Konstruktory

Binding()	Inicializuje novou instanci Binding třídy .
Binding(String)	Inicializuje novou instanci Binding třídy s počáteční cestou.

Pole

DoNothing	Používá se jako vrácená hodnota, která dává modulu vazeb pokyn, aby neprovádět žádnou akci.
IndexerName	Používá se jako PropertyName z PropertyChangedEventArgs k označení, že se změnila vlastnost indexeru.
SourceUpdatedEvent	Identifikuje přidruženou SourceUpdated událost.
TargetUpdatedEvent	Identifikuje přidruženou TargetUpdated událost.
XmlNamespaceManagerProperty	Identifikuje přidruženou XmlNamespaceManager vlastnost.

Vlastnosti

AsyncState	Získá nebo nastaví neprůhledná data předávaná asynchronnímu dispečeru dat.
BindingGroupName	Získá nebo nastaví název BindingGroup , ke kterému patří tato vazba. (Zděděno od BindingBase)
BindsDirectlyToSource	Získá nebo nastaví hodnotu, která označuje, zda se má vyhodnotit Path relativní k datové položce nebo objektu DataSourceProvider .
Converter	Získá nebo nastaví převaděč pro použití.
ConverterCulture	Získá nebo nastaví jazykovou verzi, ve které chcete vyhodnotit převaděč.
ConverterParameter	Získá nebo nastaví parametr pro předání do .Converter
Delay	Získá nebo nastaví dobu, v milisekundách, čekat před aktualizací zdroje vazby po změně hodnoty v cíli. (Zděděno od BindingBase)
ElementName	Získá nebo nastaví název elementu použít jako objekt zdroje vazby.
FallbackValue	Získá nebo nastaví hodnotu použít, když vazba nemůže vrátit hodnotu. (Zděděno od BindingBase)
IsAsync	Získá nebo nastaví hodnotu, která označuje, zda Binding by měly získat a nastavit hodnoty asynchronně.
Mode	Získá nebo nastaví hodnotu, která určuje směr toku dat ve vazbě.
NotifyOnSourceUpdated	Získá nebo nastaví hodnotu, která označuje, zda vyvolat SourceUpdated událost při přenosu hodnoty z cíle vazby do zdroje vazby.
NotifyOnTargetUpdated	Získá nebo nastaví hodnotu, která označuje, zda vyvolat TargetUpdated událost při přenosu hodnoty ze zdroje vazby do cíle vazby.
NotifyOnValidationError	Získá nebo nastaví hodnotu, která označuje, zda se má vyvolat Error přidružená událost na vázaném objektu.
Path	Získá nebo nastaví cestu k vlastnosti zdroje vazby.
RelativeSource	Získá nebo nastaví zdroj vazby zadáním jeho umístění vzhledem k pozici cíle vazby.
Source	Získá nebo nastaví objekt použít jako zdroj vazby.
StringFormat	Získá nebo nastaví řetězec, který určuje, jak formátovat vazbu, pokud zobrazí vázanou hodnotu jako řetězec. (Zděděno od BindingBase)
TargetNullValue	Získá nebo nastaví hodnotu, která se použije v cíli, pokud je `null`hodnota zdroje . (Zděděno od BindingBase)
UpdateSourceExceptionFilter	Získá nebo nastaví obslužnou rutinu, kterou můžete použít k poskytnutí vlastní logiky pro zpracování výjimek, které modul vazeb narazí během aktualizace hodnoty zdroje vazby. To platí jenom v případě, že jste k vazbě přidružovali ExceptionValidationRule .
UpdateSourceTrigger	Získá nebo nastaví hodnotu, která určuje časování aktualizace zdroje vazby.
ValidatesOnDataErrors	Získá nebo nastaví hodnotu, která označuje, zda se má zahrnout DataErrorValidationRule.
ValidatesOnExceptions	Získá nebo nastaví hodnotu, která označuje, zda se má zahrnout ExceptionValidationRule.
ValidatesOnNotifyDataErrors	Získá nebo nastaví hodnotu, která označuje, zda se má zahrnout NotifyDataErrorValidationRule.
ValidationRules	Získá kolekci pravidel, která kontrolují platnost vstupu uživatele.
XPath	Získá nebo nastaví `XPath` dotaz, který vrátí hodnotu ve zdroji vazby XML použít.

Přidružené vlastnosti

XmlNamespaceManager

Získá nebo nastaví XmlNamespaceManager k provádění dotazů oboru XPath názvů ve vazbách XML.

Metody

AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Přidá obslužnou rutinu pro připojenou SourceUpdated událost.
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Přidá obslužnou rutinu pro připojenou TargetUpdated událost.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
GetXmlNamespaceManager(DependencyObject)	Vrátí objekt správce oboru názvů XML používaný vazbou připojenou k zadanému objektu.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ProvideValue(IServiceProvider)	Vrátí objekt, který by měl být nastaven na vlastnost, kde je použita tato vazba a rozšíření. (Zděděno od BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Odebere obslužnou rutinu pro připojenou SourceUpdated událost.
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Odebere obslužnou rutinu pro připojenou TargetUpdated událost.
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)	Nastaví objekt správce oboru názvů používaný vazbou připojenou k zadanému elementu.
ShouldSerializeFallbackValue()	Vrátí hodnotu, která označuje, zda serializační procesy mají serializovat efektivní hodnotu FallbackValue vlastnosti v instancích této třídy. (Zděděno od BindingBase)
ShouldSerializePath()	Určuje, zda Path má být vlastnost zachována.
ShouldSerializeSource()	Určuje, zda Source má být vlastnost zachována.
ShouldSerializeTargetNullValue()	Vrátí hodnotu, která určuje, zda TargetNullValue má být vlastnost serializována. (Zděděno od BindingBase)
ShouldSerializeValidationRules()	Určuje, zda ValidationRules má být vlastnost zachována.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Přidružené události

SourceUpdated	Vyvolá se při přenosu hodnoty z cíle vazby do zdroje vazby, ale pouze pro vazby s hodnotou nastavenou NotifyOnSourceUpdated na `true`.
TargetUpdated	Vyvolá se při přenosu hodnoty ze zdroje vazby do cíle vazby, ale pouze pro vazby s hodnotou nastavenou NotifyOnTargetUpdated na `true`.

Platí pro

Sdílet prostřednictvím