Binding Binding Binding Binding Class

Definition

Bietet Zugriff auf hoher Ebene auf die Definition einer Bindung, die die Eigenschaften von Bindungszielobjekten (üblicherweise WPF-Elemente) und eine Datenquelle (etwa eine Datenbank, eine XML-Datei oder ein beliebiges Objekt mit Daten) verbindet.Provides high-level access to the definition of a binding, which connects the properties of binding target objects (typically, WPF elements), and any data source (for example, a database, an XML file, or any object that contains data).

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

Hinweise

Die Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)-Datenbindung bietet für Anwendungen eine einfache und konsistente Möglichkeit, Daten darzustellen und mit ihnen zu interagieren.Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) data binding provides a simple and consistent way for applications to present and interact with data. Mithilfe der Datenbindung können Sie die Werte der Eigenschaften von zwei verschiedenen Objekten synchronisieren.Data binding enables you to synchronize the values of the properties of two different objects.

Zum Einrichten einer Bindung verwenden Sie die Binding -Klasse oder eine der anderen Klassen, die BindingBaseerben.To establish a binding, use the Binding class or one of the other classes that inherit BindingBase. Unabhängig von dem Objekt, das Sie binden, und der Art der Datenquelle folgt jede Bindung dem Modell, das in der folgenden Abbildung veranschaulicht wird.Regardless of what object you are binding and the nature of your data source, each binding follows the model illustrated by the following figure.

Grundlegendes Daten Bindungs DiagrammBasic data binding diagram

Die Abbildung veranschaulicht die folgenden Grund WPFWPF Legenden Konzepte für die Datenbindung.The figure demonstrates the following fundamental WPFWPF data binding concepts.

  • Jede Bindung besitzt normalerweise diese vier Komponenten: ein Bindungs Zielobjekt, eine Ziel Eigenschaft, eine Bindungs Quelle und ein Path -Objekt für den Wert in der Bindungs Quelle, der verwendet werden soll.Each binding typically has these four components: a binding target object, a target property, a binding source, and a Path to the value in the binding source to use. Wenn Sie z. b. den Inhalt einer TextBox an die Name-Eigenschaft eines Employee-Objekts binden möchten, ist das Zielobjekt das TextBox. die Ziel Eigenschaft ist die Text -Eigenschaft, der zu verwendende Wert ist Name, und das Quell Objekt ist der Mitarbeiter. Objekt.For example, if you want to bind the content of a TextBox to the Name property of an Employee object, your target object is the TextBox, the target property is the Text property, the value to use is Name, and the source object is the Employee object.

  • Die Zieleigenschaft muss eine Abhängigkeitseigenschaft sein.The target property must be a dependency property. Dies bedeutet auch, dass ein Feld nicht gebunden werden kann.This also means that you cannot bind a field. Die meisten Eigenschaften UIElement von Objekten sind Abhängigkeits Eigenschaften und die meisten Abhängigkeits Eigenschaften, mit Ausnahme der schreibgeschützten Eigenschaften, unterstützen standardmäßig die Datenbindung.Most properties of UIElement objects are dependency properties and most dependency properties, except read-only ones, support data binding by default. (Nur DependencyObject -Typen können Abhängigkeits Eigenschaften definieren UIElement , und alle DependencyObjectObjekte werden von abgeleitet.)(Only DependencyObject types can define dependency properties and all UIElement objects derive from DependencyObject.)

  • Obwohl nicht in der Abbildung angegeben, sollte beachtet werden, dass das Bindungsquellenobjekt nicht darauf beschränkt ist, als benutzerdefiniertes CLRCLR-Objekt zu fungieren.Although not specified in the figure, it should be noted that the binding source object is not restricted to being a custom CLRCLR object. Die WPFWPF-Datenbindung unterstützt Daten in Form von CLRCLR-Objekten und XMLXML.WPFWPF data binding supports data in the form of CLRCLR objects and XMLXML. Um einige Beispiele anzugeben, kann die Bindungs Quelle UIElementein, ein beliebiges Listen Objekt, ein CLRCLR - ADO.NETADO.NET Objekt, das Daten oder Webdiensten zugeordnet ist, oder ein XmlNode- XMLXML Objekt sein, das Ihre Daten enthält.To provide some examples, your binding source may be a UIElement, any list object, a CLRCLR object that is associated with ADO.NETADO.NET data or Web Services, or an XmlNode that contains your XMLXML data.

Verwenden Sie Mode die-Eigenschaft, um die Richtung des Datenflusses anzugeben.Use the Mode property to specify the direction of the data flow. Zum Erkennen von Quell Änderungen in unidirektionalen oder bidirektionalen Bindungen muss die Quelle einen geeigneten Mechanismus für die Eigenschafts INotifyPropertyChangedÄnderungs Benachrichtigung implementieren, z. b.To detect source changes in one-way or two-way bindings, the source must implement a suitable property change notification mechanism such as INotifyPropertyChanged. Ein Beispiel finden Sie unter Gewusst wie: Ändern Sie die Benachrichtigungüber Eigenschafts ÄnderungenFor an example, see How to: Implement Property Change Notification. Die UpdateSourceTrigger -Eigenschaft gibt die zeitliche Steuerung von Quell Updates an.The UpdateSourceTrigger property specifies the timing of source updates. Weitere Informationen finden Sie unter "grundlegende Daten Bindungs Konzepte" unter Übersicht über die Datenbindung.For more information, see "Basic Data Binding Concepts" in Data Binding Overview.

Verwendung von XAML-AttributenXAML Attribute Usage

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

XAML-WerteXAML Values

declarationdeclaration
NULL oder mehr Attribut Zuweisungs Klauseln, getrennt durch Kommas (,).Zero or more attribute-assignment clauses separated by commas (,). Weitere Informationen finden Sie unter Übersicht über Bindungs Markup Erweiterungen oder Bindungs Deklarationen.For more information, see Binding Markup Extension or Binding Declarations Overview.

Konstruktoren

Binding() Binding() Binding() Binding()

Initialisiert eine neue Instanz der Binding-Klasse.Initializes a new instance of the Binding class.

Binding(String) Binding(String) Binding(String) Binding(String)

Initialisiert eine neue Instanz der Binding-Klasse mit einem Anfangspfad.Initializes a new instance of the Binding class with an initial path.

Felder

DoNothing DoNothing DoNothing DoNothing

Wird als ein zurückgegebener Wert verwendet, der die Bindungs-Engine anweist, keine Aktion auszuführen.Used as a returned value to instruct the binding engine not to perform any action.

IndexerName IndexerName IndexerName IndexerName

Wird als PropertyName von PropertyChangedEventArgs verwendet, um anzugeben, dass sich eine Indexereigenschaft geändert hat.Used as the PropertyName of PropertyChangedEventArgs to indicate that an indexer property has changed.

SourceUpdatedEvent SourceUpdatedEvent SourceUpdatedEvent SourceUpdatedEvent

Bezeichnet das angefügte SourceUpdated-Ereignis.Identifies the SourceUpdated attached event.

TargetUpdatedEvent TargetUpdatedEvent TargetUpdatedEvent TargetUpdatedEvent

Bezeichnet das angefügte TargetUpdated-Ereignis.Identifies the TargetUpdated attached event.

XmlNamespaceManagerProperty XmlNamespaceManagerProperty XmlNamespaceManagerProperty XmlNamespaceManagerProperty

Bezeichnet die angefügte XmlNamespaceManager-Eigenschaft.Identifies the XmlNamespaceManager attached property.

Eigenschaften

AsyncState AsyncState AsyncState AsyncState

Ruft opake Daten ab, die an den asynchronen Datenverteiler übergeben werden, oder legt diese fest.Gets or sets opaque data passed to the asynchronous data dispatcher.

BindingGroupName BindingGroupName BindingGroupName BindingGroupName

Ruft den Namen der BindingGroup ab, zu der diese Bindung gehört, oder legt diesen fest.Gets or sets the name of the BindingGroup to which this binding belongs.

(Inherited from BindingBase)
BindsDirectlyToSource BindsDirectlyToSource BindsDirectlyToSource BindsDirectlyToSource

Ruft einen Wert ab oder legt diesen fest, der anzeigt, ob der Path relativ zum Datenelement oder zum DataSourceProvider-Objekt ausgewertet werden soll.Gets or sets a value that indicates whether to evaluate the Path relative to the data item or the DataSourceProvider object.

Converter Converter Converter Converter

Ruft den zu verwendenden Konverter ab oder legt diesen fest.Gets or sets the converter to use.

ConverterCulture ConverterCulture ConverterCulture ConverterCulture

Dient zum Abrufen oder Festlegen der Kultur, in der der Konverter ausgewertet werden soll.Gets or sets the culture in which to evaluate the converter.

ConverterParameter ConverterParameter ConverterParameter ConverterParameter

Ruft den Parameter ab, der an den Converter übergeben wird, oder legt diesen fest.Gets or sets the parameter to pass to the Converter.

Delay Delay Delay Delay

Ruft die Zeitdauer in Millisekunden ab, die gewartet wird, ehe die Bindungsquelle aktualisiert wird, nachdem sich der Wert im Ziel geändert hat, oder legt diese fest.Gets or sets the amount of time, in milliseconds, to wait before updating the binding source after the value on the target changes.

(Inherited from BindingBase)
ElementName ElementName ElementName ElementName

Ruft den Namen des Elements ab, das als Bindungsquellenobjekt verwendet werden soll, oder legt diesen fest.Gets or sets the name of the element to use as the binding source object.

FallbackValue FallbackValue FallbackValue FallbackValue

Ruft den Wert ab, der verwendet werden soll, wenn die Bindung keinen Wert zurückgeben kann, oder legt diesen fest.Gets or sets the value to use when the binding is unable to return a value.

(Inherited from BindingBase)
IsAsync IsAsync IsAsync IsAsync

Ruft einen Wert ab, der angibt, ob die Binding Werte asynchron abrufen und setzen soll.Gets or sets a value that indicates whether the Binding should get and set values asynchronously.

Mode Mode Mode Mode

Ruft einen Wert ab, der die Richtung des Datenflusses in der Bindung angibt, oder legt diesen Wert fest.Gets or sets a value that indicates the direction of the data flow in the binding.

NotifyOnSourceUpdated NotifyOnSourceUpdated NotifyOnSourceUpdated NotifyOnSourceUpdated

Ruft einen Wert ab, der angibt, ob das SourceUpdated-Ereignis ausgelöst werden soll, wenn ein Wert vom Bindungsziel zur Bindungsquelle übertragen wird, oder legt diesen Wert fest.Gets or sets a value that indicates whether to raise the SourceUpdated event when a value is transferred from the binding target to the binding source.

NotifyOnTargetUpdated NotifyOnTargetUpdated NotifyOnTargetUpdated NotifyOnTargetUpdated

Ruft einen Wert ab, der angibt, ob das TargetUpdated-Ereignis ausgelöst werden soll, wenn ein Wert von der Bindungsquelle zum Bindungsziel übertragen wird, oder legt diesen Wert fest.Gets or sets a value that indicates whether to raise the TargetUpdated event when a value is transferred from the binding source to the binding target.

NotifyOnValidationError NotifyOnValidationError NotifyOnValidationError NotifyOnValidationError

Ruft einen Wert ab oder legt diesen fest, der angibt, ob das angefügte Error -Ereignis für das gebundene Objekt ausgelöst werden soll.Gets or sets a value that indicates whether to raise the Error attached event on the bound object.

Path Path Path Path

Ruft den Pfad zur Bindungsquelleneigenschaft fest ab oder legt diesen fest.Gets or sets the path to the binding source property.

RelativeSource RelativeSource RelativeSource RelativeSource

Ruft die Bindungsquelle ab, indem deren Speicherort relativ zur Position des Bindungsziels angegeben wird, oder legt diese fest.Gets or sets the binding source by specifying its location relative to the position of the binding target.

Source Source Source Source

Ruft das Objekt ab oder legt es fest, das als Bindungsquelle verwendet werden soll.Gets or sets the object to use as the binding source.

StringFormat StringFormat StringFormat StringFormat

Ruft eine Zeichenfolge ab, die angibt, wie die Bindung formatiert werden soll, wenn diese den gebundenen Wert als Zeichenfolge anzeigt, oder legt diese fest.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

(Inherited from BindingBase)
TargetNullValue TargetNullValue TargetNullValue TargetNullValue

Ruft den Wert ab, der im Ziel verwendet wird, wenn der Wert der Quelle null ist, oder legt diesen fest.Gets or sets the value that is used in the target when the value of the source is null.

(Inherited from BindingBase)
UpdateSourceExceptionFilter UpdateSourceExceptionFilter UpdateSourceExceptionFilter UpdateSourceExceptionFilter

Ruft einen Handler ab oder legt ihn fest, mit dem Sie benutzerdefinierte Logik für das Behandeln von Ausnahmen bereitstellen können, die beim Aktualisieren des Bindungsquellwerts durch die Bindungs-Engine auftreten.Gets or sets a handler you can use to provide custom logic for handling exceptions that the binding engine encounters during the update of the binding source value. Dies gilt nur, wenn Sie Ihrer Bindung eine ExceptionValidationRule zugeordnet haben.This is only applicable if you have associated an ExceptionValidationRule with your binding.

UpdateSourceTrigger UpdateSourceTrigger UpdateSourceTrigger UpdateSourceTrigger

Ruft einen Wert ab, der die zeitliche Steuerung der Updates für die Bindungsquelle bestimmt, oder legt diesen fest.Gets or sets a value that determines the timing of binding source updates.

ValidatesOnDataErrors ValidatesOnDataErrors ValidatesOnDataErrors ValidatesOnDataErrors

Ruft einen Wert ab, der angibt, ob die DataErrorValidationRule eingeschlossen werden soll, oder legt diesen fest.Gets or sets a value that indicates whether to include the DataErrorValidationRule.

ValidatesOnExceptions ValidatesOnExceptions ValidatesOnExceptions ValidatesOnExceptions

Ruft einen Wert ab, der angibt, ob die ExceptionValidationRule eingeschlossen werden soll, oder legt diesen fest.Gets or sets a value that indicates whether to include the ExceptionValidationRule.

ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors

Ruft einen Wert ab, der angibt, ob die NotifyDataErrorValidationRule eingeschlossen werden soll, oder legt diesen fest.Gets or sets a value that indicates whether to include the NotifyDataErrorValidationRule.

ValidationRules ValidationRules ValidationRules ValidationRules

Ruft eine Auflistung von Regeln ab, durch die die Benutzereingabe auf Gültigkeit überprüft wird.Gets a collection of rules that check the validity of the user input.

XPath XPath XPath XPath

Ruft eine XPath-Abfrage ab, die den Wert der zu verwendenden XMLXML-Bindungsquelle zurückgibt, oder legt sie fest.Gets or sets an XPath query that returns the value on the XMLXML binding source to use.

Angefügte Eigenschaften

XmlNamespaceManager XmlNamespaceManager XmlNamespaceManager XmlNamespaceManager

Ruft das XmlNamespaceManager-Objekt ab, das zum Ausführen von namespacekompatiblen XPath-Abfragen in XML-Bindungen verwendet wird, oder legt es fest.Gets or sets the XmlNamespaceManager used to perform namespace-aware XPath queries in XML bindings.

Methoden

AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Fügt einen Handler für das angefügte SourceUpdated-Ereignis hinzu.Adds a handler for the SourceUpdated attached event.

AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Fügt einen Handler für das angefügte TargetUpdated-Ereignis hinzu.Adds a handler for the TargetUpdated attached event.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
GetXmlNamespaceManager(DependencyObject) GetXmlNamespaceManager(DependencyObject) GetXmlNamespaceManager(DependencyObject) GetXmlNamespaceManager(DependencyObject)

Gibt ein XMLXML-Namespace-Manager-Objekt zurück, das von der an das angegebene Objekt angefügten Bindung verwendet wird.Returns an XMLXML namespace manager object used by the binding attached to the specified object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ProvideValue(IServiceProvider) ProvideValue(IServiceProvider) ProvideValue(IServiceProvider) ProvideValue(IServiceProvider)

Gibt ein Objekt zurück, das auf die Eigenschaft festgelegt werden soll, auf die diese Bindung und Erweiterung angewendet werden.Returns an object that should be set on the property where this binding and extension are applied.

(Inherited from BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Entfernt einen Handler für das angefügte SourceUpdated-Ereignis.Removes a handler for the SourceUpdated attached event.

RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Entfernt einen Handler für das angefügte TargetUpdated-Ereignis.Removes a handler for the TargetUpdated attached event.

SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager) SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager) SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager) SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)

Legt ein Namespace-Manager-Objekt fest, das von der an das bereitgestellte Element angefügten Bindung verwendet wird.Sets a namespace manager object used by the binding attached to the provided element.

ShouldSerializeFallbackValue() ShouldSerializeFallbackValue() ShouldSerializeFallbackValue() ShouldSerializeFallbackValue()

Gibt einen Wert zurück, mit dem angegeben wird, ob Serialisierungsprozesse den tatsächlichen Wert der FallbackValue-Eigenschaft für Instanzen dieser Klasse serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the effective value of the FallbackValue property on instances of this class.

(Inherited from BindingBase)
ShouldSerializePath() ShouldSerializePath() ShouldSerializePath() ShouldSerializePath()

Gibt an, ob die Path-Eigenschaft beibehalten werden soll.Indicates whether the Path property should be persisted.

ShouldSerializeSource() ShouldSerializeSource() ShouldSerializeSource() ShouldSerializeSource()

Gibt an, ob die Source-Eigenschaft beibehalten werden soll.Indicates whether the Source property should be persisted.

ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue()

Gibt einen Wert zurück, der angibt, ob die TargetNullValue-Eigenschaft serialisiert werden soll.Returns a value that indicates whether the TargetNullValue property should be serialized.

(Inherited from BindingBase)
ShouldSerializeValidationRules() ShouldSerializeValidationRules() ShouldSerializeValidationRules() ShouldSerializeValidationRules()

Gibt an, ob die ValidationRules-Eigenschaft beibehalten werden soll.Indicates whether the ValidationRules property should be persisted.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Angefügte Ereignisse

SourceUpdated SourceUpdated SourceUpdated SourceUpdated

Tritt auf, wenn ein Wert vom Bindungsziel zur Bindungsquelle übertragen wird. Dies gilt jedoch nur für Bindungen, deren NotifyOnSourceUpdated-Wert auf true festgelegt ist.Occurs when a value is transferred from the binding target to the binding source, but only for bindings with the NotifyOnSourceUpdated value set to true.

TargetUpdated TargetUpdated TargetUpdated TargetUpdated

Tritt auf, wenn ein Wert vom Bindungsziel zur Bindungsquelle übertragen wird. Dies gilt jedoch nur für Bindungen, deren NotifyOnTargetUpdated-Wert auf true festgelegt ist.Occurs when a value is transferred from the binding source to the binding target, but only for bindings with the NotifyOnTargetUpdated value set to true.

Gilt für:

Siehe auch