Binding Osztály

Definíció

Névtér:

System.Windows.Data

Szerelvény:

PresentationFramework.dll

Magas szintű hozzáférést biztosít egy kötés definícióhoz, amely összekapcsolja a kötés célobjektumainak (általában WPF elemeinek) és bármely adatforrásnak (például adatbázisnak, XML-fájlnak vagy adatokat tartalmazó objektumnak) a tulajdonságait.

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

Öröklődés

Object

MarkupExtension

BindingBase

Binding

Megjegyzések

A Windows megjelenítési alaprendszer (WPF) adatkötése egyszerű és konzisztens módot biztosít az alkalmazások számára az adatok bemutatására és kezelésére. Az adatkötés lehetővé teszi két különböző objektum tulajdonságainak szinkronizálását.

Kötés létrehozásához használja az Binding osztályt vagy a többi öröklő BindingBaseosztály egyikét. Függetlenül attól, hogy milyen objektumot köt, és milyen jellegű az adatforrás, mindegyik kötés az alábbi ábrán látható modellt követi.

Az ábra az alábbi alapvető WPF adatkötési fogalmakat mutatja be.

• Minden kötés általában a következő négy összetevőből áll: egy kötési célobjektumból, egy céltulajdonságból, egy kötési forrásból és egy-egyből Path a kötési forrásban használandó értékhez. Ha például egy alkalmazott objektum Név tulajdonságához szeretné kötni egy TextBox adott objektum tartalmát, akkor a célobjektum a TextBoxtulajdonság, a céltulajdonság Text a tulajdonság, a használandó érték a Név, a forrásobjektum pedig az Alkalmazott objektum.

• A céltulajdonságnak függőségi tulajdonságnak kell lennie. Ez azt is jelenti, hogy nem lehet mezőt kötni. Az objektumok legtöbb tulajdonsága UIElement függőségi tulajdonságok és a legtöbb függőségi tulajdonság, kivéve az írásvédetteket, alapértelmezés szerint támogatják az adatkötést. (Csak DependencyObject a típusok definiálhatnak függőségi tulajdonságokat, és az összes UIElement objektum a DependencyObject.)

• Bár az ábrán nincs megadva, meg kell jegyezni, hogy a kötés forrásobjektuma nem korlátozódik egyéni CLR-objektumra. WPF adatkötés CLR-objektumok és XML-objektumok formájában támogatja az adatokat. Néhány példa megjelenítéséhez a kötés forrása lehet UIElement, listaobjektum, az ADO-hoz.NET adatokhoz vagy webszolgáltatásokhoz társított CLR-objektum, vagy az XML-adatokat tartalmazó XmlNode.

Mode A tulajdonság használatával adja meg az adatfolyam irányát. Az egyirányú vagy kétirányú kötések forrásváltozásainak észleléséhez a forrásnak megfelelő tulajdonságváltozás-értesítési mechanizmust kell implementálnia, például INotifyPropertyChanged. Példa : A tulajdonságmódosítási értesítés implementálása. A UpdateSourceTrigger tulajdonság a forrásfrissítések időzítését határozza meg. További információ: "Alapszintű adatkötési fogalmak" az adatkötés áttekintésében.

XAML-attribútumok használata

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

XAML-értékek

Nyilatkozat Nulla vagy több attribútum-hozzárendelési záradék vesszővel (,) elválasztva. További információ: Kötési korrektúrakiterjesztés vagy kötésdeklarációk áttekintése.

Konstruktorok

Name	Description
Binding()	Inicializálja a Binding osztály új példányát.
Binding(String)	Inicializálja az Binding osztály új példányát egy kezdeti elérési úttal.

Mezők

Name	Description
DoNothing	Visszaadott értékként használva arra utasítja a kötési motort, hogy ne hajtson végre semmilyen műveletet.
IndexerName	Ez azt PropertyNamePropertyChangedEventArgs jelzi, hogy egy indexelő tulajdonság megváltozott.
SourceUpdatedEvent	Azonosítja a SourceUpdated csatolt eseményt.
TargetUpdatedEvent	Azonosítja a TargetUpdated csatolt eseményt.
XmlNamespaceManagerProperty	Azonosítja a XmlNamespaceManager csatolt tulajdonságot.

Tulajdonságok

Name	Description
AsyncState	Lekéri vagy beállítja az aszinkron adatszolgáltatónak átadott átlátszatlan adatokat.
BindingGroupName	Lekéri vagy beállítja annak a névnek a nevét, amelyhez ez a BindingGroup kötés tartozik. (Öröklődés forrása BindingBase)
BindsDirectlyToSource	Lekéri vagy beállít egy értéket, amely jelzi, hogy az Path adatelemhez vagy az objektumhoz viszonyítva kell-e kiértékelni.DataSourceProvider
Converter	Lekéri vagy beállítja a konvertert.
ConverterCulture	Lekéri vagy beállítja azt a kultúrát, amelyben a konverter kiértékelhető.
ConverterParameter	Lekéri vagy beállítja a paramétert a .Converter
Delay	Ezredmásodpercben lekéri vagy beállítja a kötési forrás frissítésének időtartamát a célérték módosítása után. (Öröklődés forrása BindingBase)
ElementName	Lekéri vagy beállítja a kötés forrásobjektumaként használni kívánt elem nevét.
FallbackValue	Lekéri vagy beállítja a használni kívánt értéket, ha a kötés nem tud értéket visszaadni. (Öröklődés forrása BindingBase)
IsAsync	Lekéri vagy beállít egy értéket, amely azt jelzi, hogy az Binding értékeknek aszinkron módon kell-e lekérése és beállítása.
Mode	Lekéri vagy beállít egy értéket, amely a kötésben lévő adatfolyam irányát jelzi.
NotifyOnSourceUpdated	Lekéri vagy beállítja azt az SourceUpdated értéket, amely jelzi, hogy az eseményt a kötési célból a kötési forrásba továbbítja-e a rendszer.
NotifyOnTargetUpdated	Lekéri vagy beállítja azt az TargetUpdated értéket, amely jelzi, hogy az eseményt a kötési forrásból a kötési célba továbbítja-e a rendszer.
NotifyOnValidationError	Lekéri vagy beállít egy értéket, amely jelzi, hogy a Error csatolt eseményt a kötött objektumon kívánja-e emelni.
Path	Lekéri vagy beállítja a kötés forrástulajdonságának elérési útját.
RelativeSource	Lekéri vagy beállítja a kötési forrást a kötési cél helyéhez viszonyított helyének megadásával.
Source	Lekéri vagy beállítja a kötés forrásaként használni kívánt objektumot.
StringFormat	Lekéri vagy beállít egy sztringet, amely meghatározza a kötés formázását, ha a kötött értéket sztringként jeleníti meg. (Öröklődés forrása BindingBase)
TargetNullValue	Lekéri vagy beállítja a célban használt értéket, ha a forrás értéke .null (Öröklődés forrása BindingBase)
UpdateSourceExceptionFilter	Lekéri vagy beállít egy kezelőt, amellyel egyéni logikát állíthat be a kötési motor által a kötés forrásértékének frissítése során tapasztalt kivételek kezelésére. Ez csak akkor alkalmazható, ha társított egy kötést ExceptionValidationRule .
UpdateSourceTrigger	Lekéri vagy beállít egy értéket, amely meghatározza a kötés forrásfrissítéseinek időzítését.
ValidatesOnDataErrors	Lekéri vagy beállít egy értéket, amely jelzi, hogy a DataErrorValidationRule.
ValidatesOnExceptions	Lekéri vagy beállít egy értéket, amely jelzi, hogy a ExceptionValidationRule.
ValidatesOnNotifyDataErrors	Lekéri vagy beállít egy értéket, amely jelzi, hogy a NotifyDataErrorValidationRule.
ValidationRules	Lekéri a felhasználói bemenet érvényességét ellenőrző szabályok gyűjteményét.
XPath	Lekéri vagy beállít egy lekérdezést XPath , amely visszaadja a használni kívánt XML-kötési forrás értékét.

Hozzácsatolt tulajdonságok

Name	Description
XmlNamespaceManager	Lekéri vagy beállítja a XmlNamespaceManager névtérérzékeny XPath lekérdezések XML-kötésekben való végrehajtásához használt adatokat.

Metódusok

Name	Description
AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Hozzáad egy kezelőt a SourceUpdated csatolt eseményhez.
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Hozzáad egy kezelőt a TargetUpdated csatolt eseményhez.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetXmlNamespaceManager(DependencyObject)	A megadott objektumhoz csatolt kötés által használt XML-névtérkezelő objektumot adja vissza.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ProvideValue(IServiceProvider)	Egy olyan objektumot ad vissza, amelyet azon a tulajdonságon kell beállítani, ahol ezt a kötést és bővítményt alkalmazza. (Öröklődés forrása BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Eltávolít egy kezelőt a SourceUpdated csatolt eseményhez.
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Eltávolít egy kezelőt a TargetUpdated csatolt eseményhez.
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)	Beállít egy névtérkezelő objektumot, amelyet a megadott elemhez csatolt kötés használ.
ShouldSerializeFallbackValue()	Olyan értéket ad vissza, amely azt jelzi, hogy a szerializálási folyamatok szerializálják-e a tulajdonság tényleges értékét az FallbackValue osztály példányaiban. (Öröklődés forrása BindingBase)
ShouldSerializePath()	Azt jelzi, hogy a Path tulajdonságot meg kell-e őrizni.
ShouldSerializeSource()	Azt jelzi, hogy a Source tulajdonságot meg kell-e őrizni.
ShouldSerializeTargetNullValue()	Egy értéket ad vissza, amely jelzi, hogy a TargetNullValue tulajdonság szerializálva legyen-e. (Öröklődés forrása BindingBase)
ShouldSerializeValidationRules()	Azt jelzi, hogy a ValidationRules tulajdonságot meg kell-e őrizni.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Hozzácsatolt események

Name	Description
SourceUpdated	Akkor fordul elő, ha egy értéket a kötési célból a kötési forrásba helyez át, de csak olyan kötések esetén, amelyekre az NotifyOnSourceUpdated érték van beállítva true.
TargetUpdated	Akkor fordul elő, ha egy értéket a kötési forrásból a kötési célhoz ad át, de csak olyan kötések esetén, amelyekre az NotifyOnTargetUpdated érték van beállítva true.

Lásd még

• MultiBinding
• PriorityBinding