Binding Třída

Definice

Obor názvů:

System.Windows.Data

Sestavení:

PresentationFramework.dll

Poskytuje základní přístup k definici vazby, která spojuje vlastnosti cílových objektů vazby (obvykle prvky WPF) a jakýkoli zdroj dat (například databáze, soubor XML nebo jakýkoli objekt obsahující 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) poskytuje jednoduchý a konzistentní způsob, jak aplikace prezentovat 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 ostatních tříd, které dědí BindingBase. Bez ohledu na to, jaký objekt vytváříte vazby a povahu zdroje dat, každá vazba se řídí modelem znázorněným na následujícím obrázku.

Obrázek ukazuje následující základní koncepty datových vazeb WPF.

• Každá vazba má obvykle tyto čtyři komponenty: cílový objekt vazby, cílovou vlastnost, zdroj vazby a Path hodnotu ve zdroji vazby, která se má použít. Pokud například chcete svázat obsah TextBox s vlastností Name objektu Employee, je cílovým objektem TextBoxvlastnost , cílovou vlastností je Text vlastnost, hodnota, kterou chcete použít, a zdrojovým objektem je Employee.

• Cílová vlastnost musí být vlastnost závislosti. To také znamená, že pole nelze svázat. Většina vlastností UIElement objektů jsou vlastnosti závislostí a většina vlastností závislostí, s výjimkou vlastností jen pro čtení, ve výchozím nastavení podporují datovou vazbu. (Pouze DependencyObject typy mohou definovat vlastnosti závislosti a všechny UIElement objekty odvozené od DependencyObject.)

• I když není uvedeno na obrázku, je třeba poznamenat, že zdrojový objekt vazby není omezen na vlastní objekt CLR. Datová vazba WPF podporuje data ve formě objektů CLR a XML. Pokud chcete uvést některé příklady, může být zdrojem vazby UIElementjakýkoli 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. Chcete-li zjistit změny zdroje jednosměrnou nebo obousměrnou vazbou, musí zdroj implementovat vhodný mechanismus oznámení o změně vlastnosti, například INotifyPropertyChanged. Příklad naleznete v tématu Postupy: Implementace oznámení o změně vlastnosti. Vlastnost UpdateSourceTrigger určuje časování zdrojových aktualizací. 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í Nulové nebo více klauzulí přiřazení atributů oddělených čárkami (,). Další informace naleznete v tématu Binding Markup Extension or Binding Declarations Overview.

Konstruktory

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

Pole

Name	Description
DoNothing	Používá se jako vrácená hodnota, která dává modulu vazby pokyn, aby neprovádí žádnou akci.
IndexerName	Používá se jako označení PropertyNamePropertyChangedEventArgs , že se změnila vlastnost indexeru.
SourceUpdatedEvent	Identifikuje připojenou SourceUpdated událost.
TargetUpdatedEvent	Identifikuje připojenou TargetUpdated událost.
XmlNamespaceManagerProperty	Identifikuje připojenou XmlNamespaceManager vlastnost.

Vlastnosti

Name	Description
AsyncState	Získá nebo nastaví neprůhledná data předávaná asynchronnímu dispečeru dat.
BindingGroupName	Získá nebo nastaví název BindingGroup , do kterého tato vazba patří. (Zděděno od BindingBase)
BindsDirectlyToSource	Získá nebo nastaví hodnotu, která urč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é se má vyhodnotit převaděč.
ConverterParameter	Získá nebo nastaví parametr předat do Converter.
Delay	Získá nebo nastaví dobu v milisekundách čekat před aktualizací zdroje vazby po hodnotě cíle změny. (Zděděno od BindingBase)
ElementName	Získá nebo nastaví název elementu použít jako vazba zdrojový objekt.
FallbackValue	Získá nebo nastaví hodnotu, která se má použít, když vazba nemůže vrátit hodnotu. (Zděděno od BindingBase)
IsAsync	Získá nebo nastaví hodnotu, která určuje, zda Binding má získat a nastavit hodnoty asynchronně.
Mode	Získá nebo nastaví hodnotu, která označuje směr toku dat v vazbě.
NotifyOnSourceUpdated	Získá nebo nastaví hodnotu, která určuje, zda má vyvolat SourceUpdated událost při přenosu hodnoty z cíle vazby do zdroje vazby.
NotifyOnTargetUpdated	Získá nebo nastaví hodnotu, která určuje, zda má vyvolat TargetUpdated událost při přenosu hodnoty ze zdroje vazby do cíle vazby.
NotifyOnValidationError	Získá nebo nastaví hodnotu, která určuje, zda má vyvolat připojenou Error událost u vázaného objektu.
Path	Získá nebo nastaví cestu ke zdrojové vlastnosti 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, který se má 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žívá v cíli, když je nullhodnota 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, se kterými se modul vazeb setká během aktualizace zdrojové hodnoty vazby. To platí jenom v případě, že jste přidružovali ExceptionValidationRule vazbu.
UpdateSourceTrigger	Získá nebo nastaví hodnotu, která určuje časování aktualizací zdroje vazby.
ValidatesOnDataErrors	Získá nebo nastaví hodnotu, která označuje, zda zahrnout DataErrorValidationRule.
ValidatesOnExceptions	Získá nebo nastaví hodnotu, která označuje, zda zahrnout ExceptionValidationRule.
ValidatesOnNotifyDataErrors	Získá nebo nastaví hodnotu, která označuje, zda zahrnout NotifyDataErrorValidationRule.
ValidationRules	Získá kolekci pravidel, která kontrolují platnost vstupu uživatele.
XPath	Získá nebo nastaví XPath dotaz, který vrátí hodnotu zdroje vazby XML použít.

Přidružené vlastnosti

Name	Description
XmlNamespaceManager	Získá nebo nastaví XmlNamespaceManager použité k provádění dotazů pracujících s XPath oborem názvů ve vazbách XML.

Metody

Name	Description
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.
GetXmlNamespaceManager(DependencyObject)	Vrátí objekt správce oboru názvů XML používaný vazbou připojenou k zadanému objektu.
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 SourceUpdated připojené události.
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Odebere obslužnou rutinu TargetUpdated připojené události.
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)	Nastaví objekt správce oboru názvů používaný vazbou připojenou k poskytnutému prvku.
ShouldSerializeFallbackValue()	Vrátí hodnotu, která určuje, zda serializace procesy serializovat efektivní hodnotu FallbackValue vlastnosti instance 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.

Přidružené události

Name	Description
SourceUpdated	Nastane, když je hodnota přenesena z cíle vazby do zdroje vazby, ale pouze pro vazby s hodnotou nastavenou NotifyOnSourceUpdated na true.
TargetUpdated	Nastane, když je hodnota přenesena ze zdroje vazby do cíle vazby, ale pouze pro vazby s hodnotou nastavenou NotifyOnTargetUpdated na true.

Viz také

• MultiBinding
• PriorityBinding