Binding Třída

Definice

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

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.

Diagram základních 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: 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.

Platí pro

Viz také