{Binding}-Markuperweiterung

Hinweis

Für Windows 10 steht ein neuer Bindungsmechanismus zur Verfügung, der für Leistung und Produktivität von Entwicklern optimiert ist. Siehe {x:Bind}-Markuperweiterung.

Hinweis

Allgemeine Informationen zur Verwendung der Datenbindung in Ihrer App mit {Binding} (und einen Vergleich zwischen {x:Bind} und {Binding}) finden Sie unter Datenbindung in der Tiefe.

Die {Binding} -Markuperweiterung wird verwendet, um Eigenschaften von Steuerelementen an Werte zu binden, die aus einer Datenquelle wie Code stammen. Die {Binding}-Markuperweiterung wird zur XAML-Ladezeit in eine instance der Binding-Klasse konvertiert. Dieses Bindungsobjekt erhält einen Wert von der Eigenschaft einer Datenquelle und leitet ihn an die Eigenschaft des Steuerelements weiter. Das Bindungsobjekt kann optional konfiguriert werden, um Änderungen am Wert der Datenquelleneigenschaft zu beobachten und sich basierend auf diesen Änderungen zu aktualisieren. Es kann optional auch so konfiguriert werden, dass Änderungen am Wert des Steuerelements per Push zurück an die Quelleigenschaft gesendet werden. Die als Ziel einer Datenbindung verwendete Eigenschaft muss eine Abhängigkeitseigenschaft sein. Weitere Informationen finden Sie unter Übersicht über Abhängigkeitseigenschaften.

{Binding} weist die gleiche Rangfolge für Abhängigkeitseigenschaften auf wie ein lokaler Wert. So wird beim Festlegen eines lokalen Werts im imperativen Code der Effekt aller im Markup festgelegten {Binding}-Objekte entfernt.

XAML-Attributsyntax

<object property="{Binding}" .../>
-or-
<object property="{Binding propertyPath}" .../>
-or-
<object property="{Binding bindingProperties}" .../>
-or-
<object property="{Binding propertyPath, bindingProperties}" .../>

Begriff	BESCHREIBUNG
Propertypath	Eine Zeichenfolge, die den Eigenschaftspfad für die Bindung angibt. Weitere Informationen finden Sie unten im Abschnitt Eigenschaftspfad.
bindingProperties	Propname=value[, propName=value]* Mindestens eine Bindungseigenschaft, die mithilfe einer Name-Wert-Paarsyntax angegeben wird.
propName	Der Zeichenfolgenname der Eigenschaft, die für das Binding-Objekt festgelegt werden soll. Beispiel: „Konverter“.
value	Der für die Eigenschaft festzulegende Wert. Die Syntax des Arguments hängt von der Eigenschaft der festgelegten Binding-Klasse ab. Weitere Informationen finden Sie unten im Abschnitt Mit {Binding} festlegbare Eigenschaften der Bindungsklasse.

Eigenschaftspfad

Path beschreibt die Eigenschaft, an die Sie binden (die Quelleigenschaft). „Path“ ist ein Positionsparameter. Das bedeutet, dass Sie den Parameternamen explizit verwenden können ({Binding Path=EmployeeID}) oder dass Sie ihn als ersten nicht benannten Parameter angeben können ({Binding EmployeeID}).

Der Path-Typ ist ein Eigenschaftspfad. Es handelt sich dabei um eine Zeichenfolge, die als Eigenschaft oder Untereigenschaft Ihres benutzerdefinierten Typs oder eines Frameworktyps ausgewertet wird. Der Typ kann auch eine DependencyObject-Klasse sein. Die Schritte in einem Eigenschaftspfad werden durch Punkte getrennt (.), und Sie können mehrere Trennzeichen angeben, um aufeinander folgende untergeordnete Eigenschaften zu durchlaufen. Verwenden Sie unabhängig von der verwendeten Programmiersprache einen Punkt als Trennzeichen, um das Objekt zu implementieren, an das die Bindung erfolgt.

Zum Binden der Benutzeroberfläche an die Vornameneigenschaft eines Mitarbeiterobjekts können Sie z. B. „Employee.FirstName“ als Eigenschaftspfad verwenden. Wenn Sie ein ItemsControl-Element an eine Eigenschaft binden, die die abhängigen Elemente des Mitarbeiters enthält, kann der Eigenschaftspfad „Employee.Dependents“ lauten, und die Elementvorlage des ItemsControl-Elements wäre für die Anzeige der Elemente „Dependents“ verantwortlich.

Wenn die Datenquelle eine Auflistung ist, kann der Eigenschaftspfad Elemente in der Auflistung anhand ihrer Position oder ihres Indexes angeben. Beispiel: "Teams[0]. Spieler", wobei das Literal "[]" die "0" umschließt, die das erste Element in einer Sammlung angibt.

Wenn Sie eine ElementName-Eigenschaft an eine vorhandene DependencyObjectKlasse binden, können Sie angefügte Eigenschaften als Teil des Eigenschaftspfads verwenden. Wenn Sie eine angefügte Eigenschaft eindeutig machen möchten, damit der Zwischenpunkt im Namen der angefügten Eigenschaften nicht als Schritt in einen Eigenschaftspfad angesehen wird, müssen Sie Klammern um den besitzerqualifizierten Namen der angefügten Eigenschaft setzen – z. B. (AutomationProperties.Name).

Es wird ein Zwischenobjekt des Eigenschaftspfads als PropertyPath-Objekt in einer Laufzeitdarstellung gespeichert, in den meisten Fällen ist jedoch keine Interaktion mit einem PropertyPath-Objekt im Code erforderlich. Sie können i. d. R. die Bindungsinformationen angeben, wenn Sie XAML verwenden möchten.

Weitere Informationen zur Zeichenfolgensyntax für einen Eigenschaftspfad, zu Eigenschaftspfaden in Animationsfeaturebereichen und zum Erstellen eines PropertyPath-Objekts finden Sie unter Property-path syntax.

Mit {Binding} festlegbare Eigenschaften der Bindungsklasse

{Binding} wird mit der bindingProperties-Platzhaltersyntax angegeben, da in der Markuperweiterung mehrere Lese-/Schreibeigenschaften einer Binding-Klasse festgelegt werden können. Die Eigenschaften können mit kommagetrennten propName-Wertpaaren= in beliebiger Reihenfolge festgelegt werden. Für einige Eigenschaften sind Typen erforderlich, die keine Typkonvertierung enthalten, sodass für diese eigene innerhalb von {Binding} geschachtelte Markuperweiterungen erforderlich sind.

Eigenschaft	BESCHREIBUNG
Pfad	Weitere Informationen finden Sie weiter oben im Abschnitt Eigenschaftspfad.
Converter	Gibt ein Konverterobjekt an, das vom Bindungsmodul aufgerufen wird. Der Konverter kann im Markupcode mit der {StaticResource}-Markuperweiterung festgelegt werden, um aus einem Ressourcenwörterbuch auf dieses Objekt zu verweisen.
ConverterLanguage	Gibt die Kultur an, die vom Konverter verwendet werden soll. (Wenn Sie eine Converter-Eigenschaft festlegen.) Die Kultur kann als standardbasierter Bezeichner festgelegt werden. Weitere Informationen finden Sie unter ConverterLanguage.
ConverterParameter	Gibt einen Konverterparameter an, der in der Konverterlogik verwendet werden kann. (Wenn Sie eine Converter-Eigenschaft festlegen.) Die meisten Konverter verwenden einfache Logik und rufen alle erforderlichen Informationen aus dem zu konvertierenden übergebenen Wert ab. Sie benötigen keinen ConverterParameter-Wert. Der ConverterParameter-Parameter ist für komplexere Konverterimplementierungen mit bedingter Logik gedacht, bei der überprüft wird, was in ConverterParameter übergeben wird. Sie können auch einen Konverter schreiben, der keine Zeichenfolgenwerte verwendet. Dies ist jedoch sehr ungewöhnlich. Weitere Informationen finden Sie in den „Anmerkungen“ zu ConverterParameter.
ElementName	Gibt eine Datenquelle durch Verweis auf ein anderes Element in demselben XAML-Konstrukt an, das über eine Name-Eigenschaft oder ein x:Name-Attribut verfügt. Damit werden häufig zusammengehörige Werte oder Untereigenschaften eines Benutzeroberflächenelements gemeinsam verwendet, um einen bestimmten Wert für ein anderes Element bereitzustellen, z. B. in einer XAML-Steuerelementvorlage.
FallbackValue	Gibt einen Wert an, der angezeigt wird, wenn die Quelle oder der Pfad nicht aufgelöst werden können.
Mode	Gibt den Bindungsmodus als einen der folgenden Werte an: „OneTime“, „OneWay“ oder „TwoWay“. Diese Zeichenfolgen entsprechen den Konstantennamen der BindingMode-Enumeration. Der Standardwert ist "OneWay". Beachten Sie, dass dieser vom Standard für {x:Bind} abweicht, der „OneTime“ lautet.
RelativeSource	Gibt durch das Beschreiben der Position der Bindungsquelle relativ zur Position des Bindungsziels eine Datenquelle an. Dies wird am häufigsten in Bindungen innerhalb von XAML-Steuervorlagen verwendet. Legen Sie die {RelativeSource}-Markuperweiterung fest.
Quelle	Gibt die Objektdatenquelle an. In der Binding-Markuperweiterung erfordert die Source-Eigenschaft einen Objektverweis, beispielsweise einen Verweis in der {StaticResource}-Markuperweiterung Ist die Eigenschaft nicht angegeben, wird die Quelle vom aktiven Datenkontext angegeben. Häufig wird ein Source-Wert nicht in einzelnen Bindungen angegeben, sondern stattdessen der gemeinsame DataContext für mehrere Bindungen verwendet. Weitere Informationen finden Sie unter DataContext oder Datenbindung im Detail.
TargetNullValue	Gibt einen Wert an, der angezeigt wird, wenn der Quellwert aufgelöst werden kann, aber explizit null ist.
UpdateSourceTrigger	Gibt den Zeitpunkt für Aktualisierungen von Bindungsquellen an. Wenn keine Angabe erfolgt, lautet der Standardwert Default.

Hinweis Wenn Sie Markup von {x:Bind} in {Binding} konvertieren, beachten Sie die Unterschiede in den Standardwerten für die Mode-Eigenschaft .

Converter, ConverterLanguage und ConverterLanguage hängen mit der Konvertierung eines Werts oder Typs aus der Bindungsquelle in einen mit der Bindungszieleigenschaft kompatiblen Typ oder Wert zusammen. Weitere Informationen und Beispiele finden Sie im Abschnitt „Datenkonvertierungen“ unter Datenbindung im Detail.

Hinweis

Ab Windows 10, Version 1607, wird über das XAML-Framework ein integrierter Konverter für die Konvertierung eines booleschen Operanden in einen Sichtbarkeitszustand bereitgestellt. Der Konverter ordnet true dem Visible-Enumerationswert und false dem Wert "Reduziert " zu, damit Sie eine Visibility-Eigenschaft an einen Booleschen Wert binden können, ohne einen Konverter zu erstellen. Für die Verwendung des integrierten Konverters muss die SDK-Zielversion der App mindestens 14393 lauten. Die Verwendung ist nicht möglich, wenn Ihre App für frühere Versionen von Windows 10 bestimmt ist. Weitere Informationen zu Zielversionen finden Sie unter Versionsadaptiver Code.

Source, RelativeSource und ElementName geben eine Bindungsquelle an und schließen sich somit gegenseitig aus.

Tipp Wenn Sie eine einzelne geschweifte Klammer für einen Wert angeben müssen, z. B. in Path oder ConverterParameter, stellen Sie ihm einen umgekehrten Schrägstrich voran: \{. Setzen Sie alternativ die gesamte Zeichenfolge mit den geschweiften Klammern, für die Escapezeichen verwendet werden müssen, in weitere Anführungszeichen, z. B. ConverterParameter='{Mix}'.

Beispiele

<!-- binding a UI element to a view model -->    
<Page ... >
    <Page.DataContext>
        <local:BookstoreViewModel/>
    </Page.DataContext>

    <GridView ItemsSource="{Binding BookSkus}" SelectedItem="{Binding SelectedBookSku, Mode=TwoWay}" ... />
</Page>

<!-- binding a UI element to another UI element -->
<Page ... >
    <Page.Resources>
        <local:S2Formatter x:Key="GradeConverter"/>
    </Page.Resources>

    <Slider x:Name="sliderValueConverter" ... />
    <TextBox Text="{Binding Path=Value, ElementName=sliderValueConverter,
        Mode=OneWay,
        Converter={StaticResource GradeConverter}}"/>
</Page>

Im zweiten Beispiel werden vier unterschiedliche Binding-Eigenschaften festgelegt: ElementName, Path, Mode und Converter. Path wird in diesem Fall explizit als Binding-Eigenschaft benannt gezeigt. Die Path-Eigenschaft wird zu einer Datenbindungsquelle ausgewertet, bei der es sich um ein anderes Objekt in derselben Laufzeit-Objektstruktur handelt – ein Slider mit dem Namen sliderValueConverter.

Beachten Sie, dass der Converter-Eigenschaftswert eine weitere Markuperweiterung ({StaticResource} markup extension) verwendet, sodass hier zwei geschachtelte Markuperweiterungssyntaxen zu sehen sind. Die innere Syntax wird zuerst ausgewertet. Nach dem Abrufen der Ressource ist daher ein IValueConverter verfügbar (eine benutzerdefinierte Klasse, die vom local:S2Formatter-Element in Ressourcen instanziiert wird), den die Bindung verwenden kann.

Unterstützung von Tools

Mit Microsoft IntelliSense in Microsoft Visual Studio werden die Eigenschaften des Datenkontexts beim Erstellen von {Binding} im XAML-Markup-Editor angezeigt. Sobald Sie „{Binding“ eingeben, werden für die Path-Eigenschaft geeignete Datenkontexteigenschaften in der Dropdownliste angezeigt. IntelliSense bietet auch Unterstützung für andere Eigenschaften von Binding. Damit dies funktioniert muss der Datenkontext oder der Entwurfszeit-Datenkontext auf der Markupseite festgelegt werden. Gehe zu Definition (F12) funktioniert auch bei {Binding}. Alternativ können Sie das Dialogfeld „Datenbindung“ verwenden.