Binding Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Data

Zestaw:: PresentationFramework.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapewnia wysoki poziom dostępu do definicji powiązania, która łą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).

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

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ą BindingBase. Niezależnie od tego, jaki obiekt jest wiązany i charakter źródła danych, każde powiązanie jest zgodne z modelem przedstawionym na poniższej ilustracji.

Podstawowy diagram powiązania danych — podstawowy diagram powiązania

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

Każde powiązanie zwykle ma te cztery składniki: obiekt docelowy powiązania, właściwość docelową, źródło powiązania i Path wartość w źródle powiązania do użycia. Jeśli na przykład chcesz powiązać zawartość TextBox obiektu Nazwa obiektu Employee, obiekt docelowy to , właściwość docelowa jest TextBox Text właściwością docelową, wartością, której należy użyć, jest nazwa, a obiekt źródłowy jest obiektem 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, obsługuje powiązanie danych domyślnie. (Tylko DependencyObject typy mogą definiować właściwości zależności i wszystkie UIElement obiekty pochodzące z DependencyObject.
Chociaż nie określono 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 listy , obiektem UIElementCLR skojarzonym z danymi ADO.NET lub usługami sieci Web lub xmlnode zawierającym dane XML.

Użyj właściwości , Mode 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 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ązania danych.

Użycie atrybutu języka XAML

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

Wartości XAML

Deklaracji
Zero lub więcej klauzul przypisania atrybutów oddzielonych 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 z początkową ścieżką.

Pola

DoNothing	Użyto jako zwracanej wartości, aby poinstruować aparat powiązania, aby nie wykonywał żadnej akcji.
IndexerName	Użyto jako PropertyName elementu , PropertyChangedEventArgs aby wskazać, że właściwość indeksatora uległa zmianie.
SourceUpdatedEvent	Identyfikuje SourceUpdated dołączone zdarzenie.
TargetUpdatedEvent	Identyfikuje TargetUpdated 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 należy ocenić 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, który ma być przekazywany do parametru Converter.
Delay	Pobiera lub ustawia czas oczekiwania w milisekundach przed aktualizacją ź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ść wskazującą, czy Binding wartości powinny być pobierane i ustawiane 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ć przenoszone SourceUpdated z elementu docelowego powiązania do źródła powiązania.
NotifyOnTargetUpdated	Pobiera lub ustawia wartość wskazującą, czy zdarzenie ma być przenoszone TargetUpdated z źródła powiązania do elementu docelowego powiązania.
NotifyOnValidationError	Pobiera lub ustawia wartość wskazującą, czy należy zgłosić 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 określający sposób formatowania powiązania, jeśli wyświetla wartość powiązana 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 napotkanych przez aparat powiązania 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ść określającą czas aktualizacji źródła powiązania.
ValidatesOnDataErrors	Pobiera lub ustawia wartość wskazującą, czy należy dołączyć element DataErrorValidationRule.
ValidatesOnExceptions	Pobiera lub ustawia wartość wskazującą, czy należy dołączyć element ExceptionValidationRule.
ValidatesOnNotifyDataErrors	Pobiera lub ustawia wartość wskazującą, czy należy dołączyć element NotifyDataErrorValidationRule.
ValidationRules	Pobiera kolekcję reguł sprawdzających ważność danych wejściowych użytkownika.
XPath	Pobiera lub ustawia `XPath` zapytanie zwracające wartość źródła 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 dołączonego SourceUpdated zdarzenia.
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Dodaje procedurę obsługi 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 bieżące wystąpienie. (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 powinien być ustawiony we właściwości, w której zastosowano 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 dla powiązań z wartością ustawioną na NotifyOnSourceUpdated`true`.
TargetUpdated	Występuje, gdy wartość jest przenoszona ze źródła powiązania do elementu docelowego powiązania, ale tylko dla powiązań z wartością ustawioną na NotifyOnTargetUpdated`true`.

Dotyczy