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 elementy 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 Windows Presentation Foundation (WPF) 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 vazbu a povahu zdroje dat, každá vazba se řídí modelem znázorněným na následujícím obrázku.

Obrázek znázorňuje 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, kterou chcete použít. Pokud například chcete vytvořit vazbu obsahu TextBox s vlastností Jméno objektu Employee, cílový objekt je TextBoxvlastnost , cíl je Text vlastnost, hodnota, kterou chcete použít, a zdrojovým objektem je Employee objekt.

• Cílová vlastnost musí být vlastnost závislosti. To také znamená, že nemůžete svázat pole. Většina vlastností objektů jsou vlastnosti UIElement 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ávislostí a všechny UIElement objekty odvozené od DependencyObject.)

• I když není na obrázku uvedeno, 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 vaše data XML.

Mode Pomocí vlastnosti určete směr toku dat. Pokud chcete zjistit změny zdroje jednosměrně nebo obousměrně, musí zdroj implementovat vhodný mechanismus oznámení o změně vlastnosti, jako INotifyPropertyChangedje . Příklad najdete v tématu Postupy: Implementace oznámení o změně vlastnosti. Vlastnost UpdateSourceTrigger určuje č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í
Klauzule přiřazení atributů oddělených čárkami (,) nebo více. Další informace najdete v tématu Přehled rozšíření značek vazeb nebo deklarací vazeb.

Konstruktory

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

Pole

DoNothing	Používá se jako vrácená hodnota, která dává modulu vazby pokyn, aby neprovážil žádnou akci.
IndexerName	Slouží k PropertyName PropertyChangedEventArgs označení, ž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

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á označuje, zda se má vyhodnotit Path relativní hodnota 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 pro předání do Converter.
Delay	Získá nebo nastaví dobu čekání v milisekundách, než aktualizuje zdroj vazby po hodnotě cílových změn. (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á označ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á označuje, zda má SourceUpdated vyvolat událost při přenosu hodnoty z cíle vazby do zdroje vazby.
NotifyOnTargetUpdated	Získá nebo nastaví hodnotu, která označuje, zda se má událost vyvolat TargetUpdated při přenosu hodnoty ze zdroje vazby do cíle vazby.
NotifyOnValidationError	Získá nebo nastaví hodnotu, která označ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 vazební modul setká během aktualizace zdrojové hodnoty vazby. To platí jenom v případě, že jste k vaší vazbě přidružovali ExceptionValidationRule .
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 ve zdroji vazby XML, který se má použít.

Přidružené vlastnosti

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

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í funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (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ří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ProvideValue(IServiceProvider)	Vrátí objekt, který by měl být nastaven na vlastnost, kde se tato vazba a rozšíření použijí. (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 prvku.
ShouldSerializeFallbackValue()	Vrátí hodnotu, která označuje, zda serializace procesy serializace má serializovat efektivní hodnotu FallbackValue vlastnosti u instancí 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á označ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	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