Binding Klasa

Definicja

Przestrzeń nazw:

System.Windows.Data

Zestaw:

PresentationFramework.dll

Zapewnia ogólny dostęp do definicji powiązania, które łączy właściwości obiektów docelowych powiązania (zazwyczaj elementów WPF) i dowolnego źródła danych (na przykład bazy danych, pliku XML lub dowolnego obiektu zawierającego dane).

C#

public class Binding : System.Windows.Data.BindingBase

Dziedziczenie

Object

MarkupExtension

BindingBase

Binding

Uwagi

Powiązania danych platformy Windows Presentation Foundation (WPF) zapewniają prosty i spójny sposób prezentowania danych i interakcji z nimi w aplikacjach. Powiązanie danych umożliwia synchronizowanie wartości właściwości dwóch różnych obiektów.

Aby ustanowić powiązanie, użyj Binding klasy lub jednej z innych klas, które dziedziczą BindingBaseelement . Niezależnie od tego, jaki obiekt jest wiązany i jaki jest charakter źródła danych, każde powiązanie jest zgodne z modelem przedstawionym na poniższym rysunku.

Na rysunku przedstawiono następujące podstawowe pojęcia dotyczące powiązań danych WPF.

• Każde powiązanie zwykle ma następujące cztery składniki: obiekt docelowy powiązania, właściwość docelową, źródło powiązania i wartość Path w źródle powiązania do użycia. Jeśli na przykład chcesz powiązać zawartość TextBox elementu z właściwością Name obiektu Employee, obiektem docelowym jest TextBox, właściwość docelowa jest Text właściwością , wartością do użycia jest Nazwa, a obiektem źródłowym jest obiekt Employee.

• Właściwość docelowa musi być właściwością zależności. Oznacza to również, że nie można powiązać pola. Większość właściwości UIElement obiektów to właściwości zależności i większość właściwości zależności, z wyjątkiem właściwości tylko do odczytu, domyślnie obsługuje powiązanie danych. (Tylko DependencyObject typy mogą definiować właściwości zależności, a wszystkie UIElement obiekty pochodzą z DependencyObject.)

• Chociaż nie określono go na rysunku, należy zauważyć, że obiekt źródłowy powiązania nie jest ograniczony do bycia niestandardowym obiektem CLR. Powiązanie danych WPF obsługuje dane w postaci obiektów CLR i XML. Aby podać kilka przykładów, źródło powiązania może być obiektem UIElementlisty, obiektem CLR skojarzonym z danymi ADO.NET lub usługami sieci Web albo xmlnode zawierającym dane XML.

Mode Użyj właściwości , aby określić kierunek przepływu danych. Aby wykryć zmiany źródła w powiązaniach jednokierunkowych lub dwukierunkowych, źródło musi zaimplementować odpowiedni mechanizm powiadamiania o zmianie właściwości, taki jak INotifyPropertyChanged. Aby zapoznać się z przykładem, zobacz How to: Implement Property Change Notification (Instrukcje: implementowanie powiadomienia o zmianie właściwości). Właściwość UpdateSourceTrigger określa czas aktualizacji źródłowych. Aby uzyskać więcej informacji, zobacz "Podstawowe pojęcia dotyczące powiązań danych" w temacie Omówienie powiązań danych.

Użycie atrybutu języka XAML

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

Wartości XAML

Deklaracji
Zero lub więcej klauzul przypisywania atrybutów rozdzielonych przecinkami (,). Aby uzyskać więcej informacji, zobacz Binding Markup Extension or Binding Declarations Overview (Omówienie powiązań rozszerzeń znaczników lub deklaracji powiązań).

Konstruktory

Binding()	Inicjuje nowe wystąpienie klasy Binding.
Binding(String)	Inicjuje Binding nowe wystąpienie klasy przy użyciu początkowej ścieżki.

Pola

DoNothing	Używana jako wartość zwracana w celu poinstruowania aparatu powiązania, aby nie wykonywał żadnej akcji.
IndexerName	Używany jako element PropertyNamePropertyChangedEventArgs , aby wskazać, że właściwość indeksatora uległa zmianie.
SourceUpdatedEvent	SourceUpdated Identyfikuje dołączone zdarzenie.
TargetUpdatedEvent	TargetUpdated Identyfikuje dołączone zdarzenie.
XmlNamespaceManagerProperty	Identyfikuje dołączoną XmlNamespaceManager właściwość.

Właściwości

AsyncState	Pobiera lub ustawia nieprzezroczyste dane przekazywane do asynchronicznego dyspozytora danych.
BindingGroupName	Pobiera lub ustawia nazwę BindingGroup , do której należy to powiązanie. (Odziedziczone po BindingBase)
BindsDirectlyToSource	Pobiera lub ustawia wartość wskazującą, czy wartość ma być obliczana Path względem elementu danych, czy DataSourceProvider obiektu.
Converter	Pobiera lub ustawia konwerter do użycia.
ConverterCulture	Pobiera lub ustawia kulturę, w której ma być obliczany konwerter.
ConverterParameter	Pobiera lub ustawia parametr do przekazania do .Converter
Delay	Pobiera lub ustawia czas oczekiwania (w milisekundach) przed zaktualizowaniem źródła powiązania po zmianie wartości docelowej. (Odziedziczone po BindingBase)
ElementName	Pobiera lub ustawia nazwę elementu, który ma być używany jako obiekt źródłowy powiązania.
FallbackValue	Pobiera lub ustawia wartość do użycia, gdy powiązanie nie może zwrócić wartości. (Odziedziczone po BindingBase)
IsAsync	Pobiera lub ustawia wartość, która wskazuje, czy Binding wartość powinna być pobierana i ustawiana asynchronicznie.
Mode	Pobiera lub ustawia wartość wskazującą kierunek przepływu danych w powiązaniu.
NotifyOnSourceUpdated	Pobiera lub ustawia wartość wskazującą, czy zdarzenie ma być wywoływane SourceUpdated , gdy wartość jest przenoszona z obiektu docelowego powiązania do źródła powiązania.
NotifyOnTargetUpdated	Pobiera lub ustawia wartość wskazującą, czy podnieść TargetUpdated zdarzenie, gdy wartość zostanie przeniesiona ze źródła powiązania do obiektu docelowego powiązania.
NotifyOnValidationError	Pobiera lub ustawia wartość wskazującą, czy wywołać Error dołączone zdarzenie w powiązanym obiekcie.
Path	Pobiera lub ustawia ścieżkę do właściwości źródłowej powiązania.
RelativeSource	Pobiera lub ustawia źródło powiązania, określając jego lokalizację względem położenia obiektu docelowego powiązania.
Source	Pobiera lub ustawia obiekt do użycia jako źródło powiązania.
StringFormat	Pobiera lub ustawia ciąg, który określa sposób formatowania powiązania, jeśli wyświetla wartość powiązaną jako ciąg. (Odziedziczone po BindingBase)
TargetNullValue	Pobiera lub ustawia wartość używaną w obiekcie docelowym, gdy wartość źródła to null. (Odziedziczone po BindingBase)
UpdateSourceExceptionFilter	Pobiera lub ustawia procedurę obsługi, której można użyć do zapewnienia niestandardowej logiki obsługi wyjątków napotykanych przez aparat powiązań podczas aktualizacji wartości źródłowej powiązania. Ma to zastosowanie tylko w przypadku skojarzenia z powiązaniem ExceptionValidationRule .
UpdateSourceTrigger	Pobiera lub ustawia wartość, która określa czas wiązania aktualizacji źródła.
ValidatesOnDataErrors	Pobiera lub ustawia wartość wskazującą, czy należy uwzględnić DataErrorValidationRuleelement .
ValidatesOnExceptions	Pobiera lub ustawia wartość wskazującą, czy należy uwzględnić ExceptionValidationRuleelement .
ValidatesOnNotifyDataErrors	Pobiera lub ustawia wartość wskazującą, czy należy uwzględnić NotifyDataErrorValidationRuleelement .
ValidationRules	Pobiera kolekcję reguł, które sprawdzają poprawność danych wejściowych użytkownika.
XPath	Pobiera lub ustawia XPath zapytanie zwracające wartość w źródle powiązania XML do użycia.

Właściwości dołączone

XmlNamespaceManager

Pobiera lub ustawia XmlNamespaceManager używane do wykonywania zapytań obsługujących XPath przestrzeń nazw w powiązaniach XML.

Metody

AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Dodaje procedurę obsługi dla dołączonego SourceUpdated zdarzenia.
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Dodaje procedurę obsługi dla dołączonego TargetUpdated zdarzenia.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetXmlNamespaceManager(DependencyObject)	Zwraca obiekt menedżera przestrzeni nazw XML używany przez powiązanie dołączone do określonego obiektu.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ProvideValue(IServiceProvider)	Zwraca obiekt, który należy ustawić we właściwości, w której jest stosowane to powiązanie i rozszerzenie. (Odziedziczone po BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Usuwa procedurę obsługi dołączonego SourceUpdated zdarzenia.
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Usuwa procedurę obsługi dołączonego TargetUpdated zdarzenia.
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)	Ustawia obiekt menedżera przestrzeni nazw używany przez powiązanie dołączone do podanego elementu.
ShouldSerializeFallbackValue()	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować efektywną wartość FallbackValue właściwości w wystąpieniach tej klasy. (Odziedziczone po BindingBase)
ShouldSerializePath()	Wskazuje, czy Path właściwość powinna być utrwalone.
ShouldSerializeSource()	Wskazuje, czy Source właściwość powinna być utrwalone.
ShouldSerializeTargetNullValue()	Zwraca wartość wskazującą, czy TargetNullValue właściwość powinna być serializowana. (Odziedziczone po BindingBase)
ShouldSerializeValidationRules()	Wskazuje, czy ValidationRules właściwość powinna być utrwalone.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia dołączone

SourceUpdated	Występuje, gdy wartość jest przenoszona z obiektu docelowego powiązania do źródła powiązania, ale tylko w przypadku powiązań z wartością ustawioną NotifyOnSourceUpdated na true.
TargetUpdated	Występuje, gdy wartość jest przenoszona ze źródła powiązania do obiektu docelowego powiązania, ale tylko dla powiązań z wartością ustawioną NotifyOnTargetUpdated na true.

Dotyczy

Zobacz też

• MultiBinding
• PriorityBinding