Binding Klasa

Definicja

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

Uwagi

Powiązanie danych Windows Presentation Foundation (WPF) zapewnia prosty i spójny sposób prezentowania i interakcji z danymi przez aplikacje. 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

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 TextBoxText 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 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ść 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ć 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 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 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 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

Zobacz też