L2DBForm.xaml-Quellcode
Diese Seite enthält und beschreibt die XAML-Quelldatei für das Beispiel für die WPF-Datenbindung mit LINQ to XML.
Allgemeine Struktur der Benutzeroberfläche
Wie es für ein WPF-Projekt typisch ist, enthält diese Datei als übergeordnetes Element das XML-Element Window, das der abgeleiteten L2XDBFrom-Klasse im LinqToXmlDataBinding-Namespace zugeordnet ist.
Der Clientbereich befindet sich innerhalb eines StackPanel-Elements, das mit einem hellblauen Hintergrund versehen ist. Dieses Steuerelement enthält vier DockPanel -Benutzeroberflächenabschnitte, die durch Separator -Balken voneinander getrennt sind. Der Zweck dieser Abschnitte wird hier beschrieben.
Jeder Abschnitt enthält eine Bezeichnung, mit dem er identifiziert wird. In den ersten beiden Abschnitten wird diese Bezeichnung durch die Verwendung eines LayoutTransform-Elements um 90° gedreht. Der restliche Teil des Abschnitts enthält entsprechend dem Zweck des Abschnitts passende Benutzeroberflächenelemente wie Textblöcke, Textfelder und Schaltflächen. Mitunter wird zur Ausrichtung dieser untergeordneten Steuerelemente ein untergeordnetes StackPanel -Steuerelement verwendet.
Abschnitt „Window.Resources“
Das <Window.Resources> -Starttag in Zeile 9 gibt den Anfang des Abschnitts <legacyBold>Window.Resources</legacyBold> an. Der Abschnitt endet mit dem Endtag in Zeile 35.
Das <ObjectDataProvider> -Tag, das sich über die Zeilen 11 bis 25 erstreckt, deklariert einen ObjectDataProvidermit dem Namen LoadedBooks, der als Quelle ein XElement verwendet. Dieses XElement-Element wird initialisiert, indem ein eingebettetes XML-Dokument (ein CDATA-Element) analysiert wird. Beachten Sie, dass Leerzeichen beim Deklarieren des eingebetteten XML-Dokuments und auch beim Analysieren des Dokuments beibehalten werden. Dies ist der Fall, weil das TextBlock-Steuerelement, das zum Anzeigen des unformatierten XML-Codes verwendet wird, keine speziellen XML-Formatierungsfunktionen besitzt.
Schließlich wird in den Zeilen 28 bis 34 eine DataTemplate mit dem Namen BookTemplate definiert. Diese Vorlage wird zum Anzeigen der Einträge im Abschnitt Buchliste der Benutzeroberfläche verwendet. Sie verwendet die Datenbindung und dynamische LINQ to XML-Eigenschaften, um über die folgenden Zuweisungen die Buch-ID und den Buchnamen abzurufen:
Text="{Binding Path=Attribute[id].Value}"Text="{Binding Path=Value}"
Code für die Datenbindung
Zusätzlich zum DataTemplate -Element wird die Datenbindung auch an einer Reihe anderer Stellen in der Datei verwendet.
Im <StackPanel> -Starttag in Zeile 38 wird die DataContext -Eigenschaft dieses Elements auf den LoadedBooks -Datenanbieter gesetzt.
DataContext="{Binding Source={StaticResource LoadedBooks}}
Damit ist das TextBlock-Element mit dem Namen tbRawXml (in Zeile 46) in der Lage, durch Bindung dieser Daten an die Xml-Eigenschaft des Datenanbieters das unformatierte XML anzuzeigen:
Text="{Binding Path=Xml}"
Das ListBox -Steuerelement in den Zeilen 58 bis 62 im Abschnitt Book List der Benutzeroberfläche legt als Vorlage für ihre Anzeigeelemente die im <legacyBold>Window.Resources</legacyBold>-Abschnitt definierte BookTemplate -Vorlage fest:
ItemTemplate ="{StaticResource BookTemplate}"
Anschließend werden die tatsächlichen Werte der Bücher in den Zeilen 59 bis 62 an dieses Listenfeld gebunden:
<ListBox.ItemsSource>
<Binding Path="Elements[{http://www.mybooks.com}book]"/>
</ListBox.ItemsSource>
Der dritte Abschnitt der Benutzeroberfläche, Edit Selected Book, bindet zuerst das DataContext -Element des übergeordneten StackPanel -Steuerelements an den aktuell ausgewählten Eintrag im Abschnitt Book List der Benutzeroberfläche (Zeile 82):
DataContext="{Binding ElementName=lbBooks, Path=SelectedItem}"
Anschließend verwendet der Abschnitt die bidirektionale Datenbindung, sodass die aktuellen Werte der Buchelemente in den beiden Textfeldern in diesem Abschnitt angezeigt und entsprechend aktualisiert werden. Die Datenbindung an dynamische Eigenschaften ähnelt der Datenbindung, die in der BookTemplate-Datenvorlage verwendet wird:
Text="{Binding Path=Attribute[id].Value}"...Text="{Binding Path=Value}"
Im XAML-Code des letzten Benutzeroberflächenabschnitts (Add New Book (Neues Buch hinzufügen)) wird keine Datenbindung verwendet. Stattdessen wird die Datenbindung im Ereignisbehandlungscode in der L2DBForm.xaml.cs-Datei durchgeführt.
Beispiel
BESCHREIBUNG
Hinweis
Wir empfehlen, den folgenden Code in einen Code-Editor, z. B. den C#-Quellcode-Editor in Visual Studio, zu kopieren, weil dort die Zeilennummern einfacher zu verfolgen sind.
Code
<Window x:Class="LinqToXmlDataBinding.L2XDBForm"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:system="clr-namespace:System;assembly=mscorlib"
xmlns:xlinq="clr-namespace:System.Xml.Linq;assembly=System.Xml.Linq"
xmlns:local="clr-namespace:LinqToXmlDataBinding"
Title="WPF Data Binding using LINQ-to-XML" Height="665" Width="500" ResizeMode="NoResize">
<Window.Resources>
<!-- Books provider and inline data -->
<ObjectDataProvider x:Key="LoadedBooks" ObjectType="{x:Type xlinq:XElement}" MethodName="Parse">
<ObjectDataProvider.MethodParameters>
<system:String xml:space="preserve">
<![CDATA[
<books xmlns="http://www.mybooks.com">
<book id="0">book zero</book>
<book id="1">book one</book>
<book id="2">book two</book>
<book id="3">book three</book>
</books>
]]>
</system:String>
<xlinq:LoadOptions>PreserveWhitespace</xlinq:LoadOptions>
</ObjectDataProvider.MethodParameters>
</ObjectDataProvider>
<!-- Template for use in Books List listbox. -->
<DataTemplate x:Key="BookTemplate">
<StackPanel Orientation="Horizontal">
<TextBlock Margin="3" Text="{Binding Path=Attribute[id].Value}"/>
<TextBlock Margin="3" Text="-"/>
<TextBlock Margin="3" Text="{Binding Path=Value}"/>
</StackPanel>
</DataTemplate>
</Window.Resources>
<!-- Main visual content container -->
<StackPanel Background="lightblue" DataContext="{Binding Source={StaticResource LoadedBooks}}">
<!-- Raw XML display section -->
<DockPanel Margin="5">
<Label Background="Gray" FontSize="12" BorderBrush="Black" BorderThickness="1" FontWeight="Bold">XML
<Label.LayoutTransform>
<RotateTransform Angle="90"/>
</Label.LayoutTransform>
</Label>
<TextBlock Name="tbRawXml" Height="200" Background="LightGray" Text="{Binding Path=Xml}" TextTrimming="CharacterEllipsis" />
</DockPanel>
<Separator Height="4" Margin="5" />
<!-- List box to display all books section -->
<DockPanel Margin="5">
<Label Background="Gray" FontSize="12" BorderBrush="Black" BorderThickness="1" FontWeight="Bold">Book List
<Label.LayoutTransform>
<RotateTransform Angle="90"/>
</Label.LayoutTransform>
</Label>
<ListBox Name="lbBooks" Height="200" Width="415" ItemTemplate ="{StaticResource BookTemplate}">
<ListBox.ItemsSource>
<Binding Path="Elements[{http://www.mybooks.com}book]"/>
</ListBox.ItemsSource>
</ListBox>
<Button Margin="5" DockPanel.Dock="Right" Height="30" Width ="130" Content="Remove Selected Book" Click="OnRemoveBook">
<Button.LayoutTransform>
<RotateTransform Angle="90"/>
</Button.LayoutTransform>
</Button>
</DockPanel>
<Separator Height="4" Margin="5" />
<!-- Edit current selection section -->
<DockPanel Margin="5">
<TextBlock Margin="5" Height="30" Width="65" DockPanel.Dock="Right" Background="LightGray" TextWrapping="Wrap" TextAlignment="Center">
Changes are live!
<TextBlock.LayoutTransform>
<RotateTransform Angle="90"/>
</TextBlock.LayoutTransform>
</TextBlock>
<StackPanel>
<Label Width="450" Background="Gray" FontSize="12" BorderBrush="Black" BorderThickness="1" HorizontalAlignment="Left" FontWeight="Bold">Edit Selected Book</Label>
<StackPanel Margin="1" DataContext="{Binding ElementName=lbBooks, Path=SelectedItem}">
<StackPanel Orientation="Horizontal">
<Label Width="40">ID:</Label>
<TextBox Name="editAttributeTextBox" Width="410" Text="{Binding Path=Attribute[id].Value}">
<TextBox.ToolTip>
<TextBlock FontWeight="Bold" TextAlignment="Center">
<Label>Edit the selected book ID and see it changed.</Label>
</TextBlock>
</TextBox.ToolTip>
</TextBox>
</StackPanel>
<StackPanel Orientation="Horizontal">
<Label Width="40">Value:</Label>
<TextBox Name="editValueTextBox" Width="410" Text="{Binding Path=Value}" Height="25">
<TextBox.ToolTip>
<TextBlock FontWeight="Bold" TextAlignment="Center">
<Label>Edit the selected book Value and see it changed.</Label>
</TextBlock>
</TextBox.ToolTip>
</TextBox>
</StackPanel>
</StackPanel>
</StackPanel>
</DockPanel>
<Separator Height="4" Margin="5" />
<!-- Add new book section -->
<DockPanel Margin="5">
<Button Margin="5" Height="30" DockPanel.Dock="Right" Click ="OnAddBook">Add Book
<Button.LayoutTransform>
<RotateTransform Angle="90"/>
</Button.LayoutTransform>
</Button>
<StackPanel>
<Label Width="450" Background="Gray" FontSize="12" BorderBrush="Black" BorderThickness="1" HorizontalAlignment="Left" FontWeight="Bold">Add New Book</Label>
<StackPanel Margin="1">
<StackPanel Orientation="Horizontal">
<Label Width="40">ID:</Label>
<TextBox Name="tbAddID" Width="410">
<TextBox.ToolTip>
<TextBlock FontWeight="Bold" TextAlignment="Center">
<Label>Enter a book ID and Value pair, then click Add Book.</Label>
</TextBlock>
</TextBox.ToolTip>
</TextBox>
</StackPanel>
<StackPanel Orientation="Horizontal">
<Label Width="40">Value:</Label>
<TextBox Name="tbAddValue" Width="410" Height="25">
<TextBox.ToolTip>
<TextBlock FontWeight="UltraBold" TextAlignment="Center">
<Label>Enter a book ID and Value pair, then click Add Book.</Label>
</TextBlock>
</TextBox.ToolTip>
</TextBox>
</StackPanel>
</StackPanel>
</StackPanel>
</DockPanel>
</StackPanel>
</Window>
Kommentare
Den C#-Quellcode für die den WPF-Benutzeroberflächenelementen zugeordneten Ereignishandler finden Sie unter L2DBForm.xaml.cs-Quellcode.
Weitere Informationen
.NET Desktop feedback
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für