Binding Klasse

Definition

Namespace:: System.Windows.Data

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bietet allgemeinen Zugriff auf die Definition einer Bindung, die die Eigenschaften von Bindungszielobjekten (in der Regel WPF-Elemente) und jede Datenquelle (z. B. eine Datenbank, eine XML-Datei oder ein Objekt, das Daten enthält) verbindet.

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

Vererbung: Object

MarkupExtension

BindingBase
Binding

Hinweise

Die Datenbindung von Windows Presentation Foundation (WPF) bietet eine einfache und konsistente Möglichkeit für Anwendungen zum Präsentieren und Interagieren mit Daten. Mit der Datenbindung können Sie die Werte der Eigenschaften von zwei verschiedenen Objekten synchronisieren.

Um eine Bindung herzustellen, verwenden Sie die Binding Klasse oder eine der anderen Klassen, die erben BindingBase. Unabhängig davon, welches Objekt Sie binden und welche Art Ihre Datenquelle hat, folgt jede Bindung dem modell, das in der folgenden Abbildung dargestellt wird.

Grundlegendes Datenbindungsdiagramm Grundlegendes

Die Abbildung zeigt die folgenden grundlegenden WPF-Datenbindungskonzepte.

Jede Bindung verfügt in der Regel über diese vier Komponenten: ein Bindungszielobjekt, eine Zieleigenschaft, eine Bindungsquelle und einen Path an den Wert in der zu verwendenden Bindungsquelle. Wenn Sie z. B. den Inhalt einer an TextBox die Name-Eigenschaft eines Employee-Objekts binden möchten, ist Ihr Zielobjekt die TextBoxEigenschaft, die Zieleigenschaft die Text Eigenschaft, der zu verwendende Wert ist Name, und das Quellobjekt ist das Employee-Objekt.
Die Zieleigenschaft muss eine Abhängigkeitseigenschaft sein. Dies bedeutet auch, dass Sie kein Feld binden können. Die meisten Eigenschaften von UIElement Objekten sind Abhängigkeitseigenschaften und die meisten Abhängigkeitseigenschaften, mit Ausnahme von schreibgeschützten Eigenschaften, unterstützen standardmäßig die Datenbindung. (Nur DependencyObject Typen können Abhängigkeitseigenschaften definieren und alle UIElement Objekte von DependencyObject.)
Obwohl in der Abbildung nicht angegeben, sollte darauf hingewiesen werden, dass das Bindungsquellobjekt nicht auf ein benutzerdefiniertes CLR-Objekt beschränkt ist. WPF-Datenbindung unterstützt Daten in Form von CLR-Objekten und XML. Um einige Beispiele bereitzustellen, kann es sich bei der Bindungsquelle um ein UIElementbeliebiges Listenobjekt, ein CLR-Objekt handeln, das ADO.NET Daten oder Webdiensten zugeordnet ist, oder ein XmlNode, das Ihre XML-Daten enthält.

Verwenden Sie die Mode Eigenschaft, um die Richtung des Datenflusses anzugeben. Um Quelländerungen in unidirektionale oder bidirektionale Bindungen zu erkennen, muss die Quelle einen geeigneten Mechanismus für Eigenschaftenänderungsbenachrichtigungen implementieren, z INotifyPropertyChanged. B. . Ein Beispiel finden Sie unter How to: Implement Property Change Notification. Die UpdateSourceTrigger Eigenschaft gibt den Zeitpunkt der Quellaktualisierungen an. Weitere Informationen finden Sie unter "Grundlegende Datenbindungskonzepte" in der Übersicht über die Datenbindung.

Verwendung von XAML-Attributen

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

XAML-Werte

Erklärung Null- oder mehr Attributzuweisungsklauseln, die durch Kommas (,) getrennt sind. Weitere Informationen finden Sie unter " Binding Markup Extension " oder "Binding Declarations Overview".

Konstruktoren

Name	Beschreibung
Binding()	Initialisiert eine neue Instanz der Binding-Klasse.
Binding(String)	Initialisiert eine neue Instanz der Binding Klasse mit einem anfänglichen Pfad.

Felder

Name	Beschreibung
DoNothing	Wird als zurückgegebener Wert verwendet, um das Bindungsmodul anzuweisen, keine Aktion auszuführen.
IndexerName	Wird verwendet, um PropertyName PropertyChangedEventArgs anzugeben, dass sich eine Indexereigenschaft geändert hat.
SourceUpdatedEvent	Identifiziert das SourceUpdated angefügte Ereignis.
TargetUpdatedEvent	Identifiziert das TargetUpdated angefügte Ereignis.
XmlNamespaceManagerProperty	Identifies the XmlNamespaceManager attached property.

Eigenschaften

Name	Beschreibung
AsyncState	Ruft undurchsichtige Daten ab, die an den asynchronen Datenverteiler übergeben werden, oder legt diese fest.
BindingGroupName	Dient zum Abrufen oder Festlegen des Namens der BindingGroup Bindung, zu der diese Bindung gehört. (Geerbt von BindingBase)
BindsDirectlyToSource	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Path relativ zum Datenelement oder das DataSourceProvider Objekt ausgewertet werden soll.
Converter	Ruft den zu verwendenden Konverter ab oder legt diesen fest.
ConverterCulture	Ruft die Kultur ab, in der der Konverter ausgewertet werden soll, oder legt diese fest.
ConverterParameter	Dient zum Abrufen oder Festlegen des Parameters, der an die Converter.
Delay	Ruft den Zeitraum in Millisekunden ab, bis die Bindungsquelle nach dem Wert für die Zieländerungen aktualisiert wird, oder legt diese fest. (Geerbt von BindingBase)
ElementName	Dient zum Abrufen oder Festlegen des Namens des Elements, das als Bindungsquellobjekt verwendet werden soll.
FallbackValue	Dient zum Abrufen oder Festlegen des Werts, der verwendet werden soll, wenn die Bindung keinen Wert zurückgeben kann. (Geerbt von BindingBase)
IsAsync	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Binding Werte asynchron abgerufen und festgelegt werden sollen.
Mode	Dient zum Abrufen oder Festlegen eines Werts, der die Richtung des Datenflusses in der Bindung angibt.
NotifyOnSourceUpdated	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das SourceUpdated Ereignis ausgelöst werden soll, wenn ein Wert vom Bindungsziel an die Bindungsquelle übertragen wird.
NotifyOnTargetUpdated	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das TargetUpdated Ereignis ausgelöst werden soll, wenn ein Wert von der Bindungsquelle an das Bindungsziel übertragen wird.
NotifyOnValidationError	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Error angefügte Ereignis für das gebundene Objekt ausgelöst werden soll.
Path	Dient zum Abrufen oder Festlegen des Pfads zur Bindungsquelleigenschaft.
RelativeSource	Ruft die Bindungsquelle ab oder legt sie fest, indem sie seine Position relativ zur Position des Bindungsziels angibt.
Source	Dient zum Abrufen oder Festlegen des Objekts, das als Bindungsquelle verwendet werden soll.
StringFormat	Dient zum Abrufen oder Festlegen einer Zeichenfolge, die angibt, wie die Bindung formatiert wird, wenn der gebundene Wert als Zeichenfolge angezeigt wird. (Geerbt von BindingBase)
TargetNullValue	Dient zum Abrufen oder Festlegen des Werts, der im Ziel verwendet wird, wenn der Wert der Quelle ist `null`. (Geerbt von BindingBase)
UpdateSourceExceptionFilter	Dient zum Abrufen oder Festlegen eines Handlers, den Sie verwenden können, um benutzerdefinierte Logik für die Behandlung von Ausnahmen bereitzustellen, die das Bindungsmodul während der Aktualisierung des Bindungsquellwerts findet. Dies gilt nur, wenn Sie eine Bindung zugeordnet ExceptionValidationRule haben.
UpdateSourceTrigger	Dient zum Abrufen oder Festlegen eines Werts, der den Zeitpunkt der Aktualisierung der Bindungsquelle bestimmt.
ValidatesOnDataErrors	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die DataErrorValidationRule.
ValidatesOnExceptions	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die ExceptionValidationRule.
ValidatesOnNotifyDataErrors	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die NotifyDataErrorValidationRule.
ValidationRules	Ruft eine Auflistung von Regeln ab, die die Gültigkeit der Benutzereingabe überprüfen.
XPath	Dient zum Abrufen oder Festlegen einer `XPath` Abfrage, die den Wert für die zu verwendende XML-Bindungsquelle zurückgibt.

Angefügte Eigenschaften

Name	Beschreibung
XmlNamespaceManager	Dient zum Abrufen oder Festlegen der XmlNamespaceManager Zum Ausführen von Namespace-fähigen `XPath` Abfragen in XML-Bindungen.

Methoden

Name	Beschreibung
AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Fügt einen Handler für das SourceUpdated angefügte Ereignis hinzu.
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Fügt einen Handler für das TargetUpdated angefügte Ereignis hinzu.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetXmlNamespaceManager(DependencyObject)	Gibt ein XML-Namespace-Manager -Objekt zurück, das von der Bindung verwendet wird, die dem angegebenen Objekt zugeordnet ist.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ProvideValue(IServiceProvider)	Gibt ein Objekt zurück, das für die Eigenschaft festgelegt werden soll, auf die diese Bindung und Erweiterung angewendet werden soll. (Geerbt von BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Entfernt einen Handler für das SourceUpdated angefügte Ereignis.
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Entfernt einen Handler für das TargetUpdated angefügte Ereignis.
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)	Legt ein Namespace-Manager-Objekt fest, das von der Bindung verwendet wird, die mit dem bereitgestellten Element verknüpft ist.
ShouldSerializeFallbackValue()	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den effektiven Wert der FallbackValue Eigenschaft auf Instanzen dieser Klasse serialisieren sollen. (Geerbt von BindingBase)
ShouldSerializePath()	Gibt an, ob die Path Eigenschaft beibehalten werden soll.
ShouldSerializeSource()	Gibt an, ob die Source Eigenschaft beibehalten werden soll.
ShouldSerializeTargetNullValue()	Gibt einen Wert zurück, der angibt, ob die TargetNullValue Eigenschaft serialisiert werden soll. (Geerbt von BindingBase)
ShouldSerializeValidationRules()	Gibt an, ob die ValidationRules Eigenschaft beibehalten werden soll.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Angefügte Ereignisse

Name	Beschreibung
SourceUpdated	Tritt auf, wenn ein Wert vom Bindungsziel an die Bindungsquelle übertragen wird, jedoch nur für Bindungen mit dem Wert, auf `true`den NotifyOnSourceUpdated der Wert festgelegt ist.
TargetUpdated	Tritt auf, wenn ein Wert von der Bindungsquelle an das Bindungsziel übertragen wird, jedoch nur für Bindungen mit dem Wert, auf `true`den NotifyOnTargetUpdated der Wert festgelegt ist.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?