Udostępnij za pośrednictwem


Binding Klasa

Definicja

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).

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

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.

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

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ż