Sdílet prostřednictvím


Binding Třída

Definice

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

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 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, 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

Viz také