Freigeben über

Beispiele für die LINQ to XML-Datenbindung

  • Artikel

Dieser Artikel beschreibt das LinqToXmlDataBinding-Beispiel, eine Windows Presentation Foundation (WPF) Anwendung, die Komponenten der Benutzeroberfläche an eine eingebettete XML-Datenquelle bindet.

Übersicht

Das LinqToXmlDataBinding-Beispiel ist eine Windows Presentation Foundation (WPF) Anwendung, die C#- und XAML-Quelldateien enthält. Ein eingebettetes XML-Dokument definiert eine Liste von Büchern. Mit der App kann der Benutzer die Bucheinträge anzeigen, hinzufügen, löschen und bearbeiten.

Es gibt zwei primäre Quelldateien:

  • L2DBForm.xaml enthält den XAML-Deklarationscode für die Benutzeroberfläche des Hauptfensters. Außerdem enthält die Datei einen Windows-Ressourcenabschnitt, in dem ein Datenanbieter und ein eingebettetes XML-Dokument für die Bücherlisten definiert sind.

  • L2DBForm.xaml.cs enthält die Initialisierungs- und Ereignisbehandlungsmethoden, die der Benutzeroberfläche zugeordnet sind.

Das Hauptfenster ist in die folgenden vier vertikalen Benutzeroberflächenabschnitte unterteilt:

  • XML: Zeigt die unformatierte XML-Quelle der eingebetteten Bücherliste an.

  • Book List (Bücherliste): Zeigt die Bucheinträge als Standardtext an, und versetzt den Benutzer in die Lage, einzelne Einträge auszuwählen und zu löschen.

  • Edit Selected Book (Ausgewähltes Buch bearbeiten): Ermöglicht es dem Benutzer, die dem aktuell ausgewählten Bucheintrag zugeordneten Werte zu bearbeiten.

  • Add New Book (Neues Buch hinzufügen): Ermöglicht das Erstellen eines neuen Bucheintrags anhand der vom Benutzer eingegebenen Werte.

Ausführen des Beispiels

In diesem Abschnitt erfahren Sie, wie Sie das LinqToXmlDataBinding-Projekt in Visual Studio erstellen und bauen und wie Sie die daraus resultierende LinqToXmlDataBinding Windows Presentation Foundation (WPF) Anwendung ausführen.

Erstellen des Projekts

  1. Starten Sie Visual Studio, und erstellen Sie eine C#-WPF-App mit dem Namen LinqToXmlDataBinding.

    Das Projekt muss .NET Framework 3.5 (oder höher) verwenden.

  2. Sofern nicht bereits vorhanden, fügen Sie Projektverweise für die folgenden .NET-Assemblys hinzu:

    • System.Data
    • System.Data.DataSetExtensions
    • System.Xml
    • System.Xml

  3. Erstellen Sie die Projektmappe, indem Sie STRG+UMSCHALTTASTE+B drücken, und führen Sie sie dann mit F5 aus.

    Das Projekt sollte ohne Fehler kompiliert und als generische WPF-Anwendung ausgeführt werden.

Code hinzufügen

  1. Benennen Sie im Projektmappen-Explorer die Quelldatei Window1.xaml in L2XDBForm.xaml um.

    Die abhängige Quelldatei Window1.xaml.cs sollte automatisch in L2XDBForm.xaml.cs umbenannt werden.

  2. Ersetzen Sie den Quellcode in der Datei L2XDBForm.xaml durch L2DBForm.xaml-Quellcode. Verwenden Sie zum Arbeiten mit dieser Datei die XAML-Quellansicht.

  3. Ersetzen Sie den Quellcode in der Datei L2XDBForm.xaml.cs durch L2DBForm.xaml.cs-Quellcode.

  4. Ersetzen Sie in der Datei App.xaml alle Vorkommen der Zeichenfolge Window1.xaml durch L2XDBForm.xaml.

  5. Erstellen Sie die Projektmappe, indem Sie STRG+UMSCHALTTASTE+B drücken.

Ausführen der App

Die LinqToXmlDataBinding-App ermöglicht es dem Benutzer, eine Liste von Büchern anzuzeigen und zu bearbeiten, die als eingebettetes XML-Element gespeichert ist. Führen Sie die App aus, indem Sie F5 (Debuggen starten) oder STRG+F5 (Start ohne Debugging) drücken.

Daraufhin wird ein Programmfenster mit dem Titel WPF-Datenbindung mit LINQ to XML angezeigt.

Achten Sie auf den obersten Abschnitt der Benutzeroberfläche. Dort wird das unformatierte XML angezeigt, das die Buchliste darstellt. Die Anzeige erfolgt unter Verwendung eines WPF-TextBlock-Steuerelements, das keine Interaktion mithilfe von Maus oder Tastatur zulässt.

Im zweiten vertikalen Abschnitt mit der Bezeichnung Book List (Buchliste) werden die Bücher als geordnete Nur-Text-Liste angezeigt. Dazu wird ein ListBox-Steuerelement verwendet, das die Auswahl über Maus oder Tastatur zulässt.

Hinzufügen und Löschen von Büchern

Wenn Sie der Liste ein neues Buch hinzufügen möchten, geben Sie in die -Steuerelemente ID und TextBox im letzten Abschnitt (Add New Book) Werte ein, und wählen Sie dann Add Book aus. Das Buch wird sowohl der Buchliste als auch der XML-Auflistung angefügt. Das Programm prüft die Eingabewerte nicht auf ihre Gültigkeit.

Wenn Sie ein vorhandenes Buch aus der Liste löschen möchten, wählen Sie es im Abschnitt Book List aus, und klicken Sie dann auf die Schaltfläche Remove Selected Book. Der Bucheintrag wird daraufhin sowohl aus der Buchliste als auch aus der unformatierten XML-Quellauflistung entfernt.

Bearbeiten eines Bucheintrags

  1. Wählen Sie den Bucheintrag im zweiten Abschnitt, Book List, aus.

    Seine aktuellen Werte werden im Bereich Ausgewähltes Buch bearbeiten angezeigt.

  2. Bearbeiten Sie die Werte mit der Tastatur. Sobald Sie zu einem anderen TextBox-Steuerelement wechseln, werden die Änderungen automatisch in die XML-Auflistung und in die Buchliste übernommen.