Exemplarische Vorgehensweise: Binden von WPF-Steuerelementen an einen WCF-Datendienst

Artikel
06/01/2015

In dieser exemplarischen Vorgehensweise erstellen Sie eine WPF-Anwendung, die datengebundene Steuerelemente enthält. Die Steuerelemente sind an Kundendatensätze gebunden, die in einem WCF Data Service gekapselt sind. Sie fügen außerdem die Schaltflächen hinzu, mit denen Kunden Datensätze anzeigen und ändern können.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

Erstellen eines Entity Data Models, das aus Daten in der Beispieldatenbank AdventureWorksLT generiert wird.
Erstellen eines WCF Data Service, der die Daten im Entity Data Model für eine WPF-Anwendung verfügbar macht.
Erstellen eines Satzes datengebundener Steuerelemente durch Ziehen von Elementen aus dem Datenquellenfenster zum WPF-Designer.
Erstellen von Schaltflächen, mit denen die Navigation vorwärts und rückwärts durch die Kundendatensätze möglich ist.
Erstellen einer Schaltfläche, die Änderungen an den Daten in den Steuerelementen des WCF Data Service und der darunterliegenden Datenquelle speichert.

Hinweis

Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Anpassen der Entwicklungseinstellungen in Visual Studio.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

Visual Studio
Zugriff auf eine laufende Instanz von SQL Server oder SQL Server Express, an die eine AdventureWorksLT-Beispieldatenbank angefügt ist. Sie können die AdventureWorksLT-Datenbankvon der CodePlex-Website herunterladen.

Vorkenntnisse der folgenden Konzepte sind ebenfalls hilfreich, wenn auch für die Durchführung der exemplarischen Vorgehensweise nicht erforderlich:

WCF Data Services. Weitere Informationen finden Sie unter Übersicht über WCF Data Services.
Datenmodelle in WCF Data Services.
Entity Data Models und der ADO.NET Entity Framework. Weitere Informationen finden Sie unter Übersicht über das Entity Framework.
Arbeiten mit dem WPF-Designer. Weitere Informationen finden Sie unter WPF Designer Overview.
WPF-Datenbindung. Weitere Informationen finden Sie unter Übersicht über Datenbindung.

Erstellen des Dienstprojekts

Beginnen Sie diese exemplarische Vorgehensweise, indem Sie ein Projekt für einen WCF Data Service erstellen.

So erstellen Sie das Dienstprojekt

Starten Sie Visual Studio.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Erweitern Sie Visual C# oder Visual Basic und wählen Sie dann Web.
Wählen Sie die Projektvorlage ASP.NET Web Application.
Geben Sie im Feld Name den Namen AdventureWorksService ein und klicken Sie OK.

Visual Studio erstellt das Projekt AdventureWorksService.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Default.aspx und wählen Sie Löschen. Diese Datei wird für diese exemplarische Vorgehensweise benötigt.

Erstellen eines Entity Data Models für den Dienst

Damit die Daten mithilfe eines WCF Data Service für eine Anwendung verfügbar gemacht werden, müssen Sie ein Datenmodell für den Dienst definieren. Der WCF Data Service unterstützt zwei Arten von Datenmodellen: Entity Data Models und benutzerdefinierte Datenmodelle, die mithilfe von Common Language Runtime (CLR) Objekten definiert werden, die die IQueryable-Schnittstelle implementieren. In dieser exemplarischen Vorgehensweise erstellen Sie ein Entity Data Model für das Datenmodell.

So erstellen Sie ein Entity Data Model

Klicken Sie im Menü Projekt auf Neues Element hinzufügen.
Klicken Sie in der Liste "Installierte Vorlagen" auf Daten und wählen Sie dann das Projektelement ADO.NET Entity Data Model aus.
Ändern Sie den Namen auf AdventureWorksModel.edmx und klicken Sie Hinzufügen.

Der Assistent für Entity Data Model wird geöffnet.
Klicken Sie auf der Seite Modellinhalt auswählen auf Aus Datenbank generieren und klicken Sie Weiter.
Wählen Sie auf der Seite Wählen Sie Ihre Datenverbindung aus eine der folgenden Optionen aus:
- Wenn in der Dropdownliste eine Datenverbindung zur Beispieldatenbank "AdventureWorksLT" verfügbar ist, wählen Sie diese aus.
  
  - oder -
- Klicken Sie Neue Verbindung und erstellen Sie eine Verbindung zur Datenbank AdventureWorksLT.
Achten Sie darauf, dass auf der Seite Wählen Sie Ihre Datenverbindung aus die Option Entitätsverbindungseinstellungen in App.Config speichern unter und klicken Sie dann auf Weiter.
Erweitern Sie auf der Seite Datenbankobjekte auswählen den Punkt Tabellen und wählen Sie dann die Tabelle SalesOrderHeader aus.
Klicken Sie auf Fertig stellen.

Erstellen des Diensts

Erstellen Sie einen WCF Data Service, der die Daten im Entity Data Model für eine WPF-Anwendung verfügbar macht.

So erstellen Sie den Dienst

Wählen Sie im Menü Projekt auf Neues Element hinzufügen.
Klicken Sie in der Liste "Installierte Vorlagen" auf Web und wählen Sie dann das Projektelement WCF Data Services aus.
Geben Sie im Feld Name den Namen AdventureWorksService.svc ein und klicken Sie Hinzufügen.

Visual Studio fügt AdventureWorksService.svc dem Projekt hinzu.

Den Dienst konfigurieren

Damit der Dienst mit dem von Ihnen erstellten Entity Data Model funktioniert, muss er konfiguriert werden.

So konfigurieren Sie den Dienst

Ersetzen Sie in der Codedatei AdventureWorks.svcdie Klassendeklaration AdventureWorksService durch folgenden Code.

Public Class AdventureWorksService
    Inherits DataService(Of AdventureWorksLTEntities)

    ' This method is called only once to initialize service-wide policies. 
    Public Shared Sub InitializeService(ByVal config As IDataServiceConfiguration)
        config.SetEntitySetAccessRule("SalesOrderHeaders", EntitySetRights.All)
        config.UseVerboseErrors = True 
    End Sub 
End Class

public class AdventureWorksService : DataService<AdventureWorksLTEntities>
{
    // This method is called only once to initialize service-wide policies. 
    public static void InitializeService(IDataServiceConfiguration config)
    {
        config.SetEntitySetAccessRule("SalesOrderHeaders", EntitySetRights.All);
    }
}

Dieser Code aktualisiert die Klasse AdventureWorksService, sodass sie sich von einem DataService ableitet, der mit der AdventureWorksLTEntities-Objektkontextklasse Ihres Entity Data Models funktioniert. Außerdem aktualisiert er die Methode InitializeService, sodass Clients des Diensts vollen Lese-/Schreibzugriff auf die SalesOrderHeader-Entität haben.

Erstellen Sie das Projekt und überprüfen Sie, ob es fehlerfrei erstellt wird.

Erstellen der WPF-Clientanwendung

Um Daten aus dem WCF Data Service anzuzeigen, erstellen Sie eine neue WPF-Anwendung mit einer Datenquelle, die auf dem Dienst basiert. Später in dieser exemplarischen Vorgehensweise werden Sie datengebundene Steuerelemente zur Anwendung hinzufügen.

So erstellen Sie die WPF-Clientanwendung

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Lösungsknoten, dann auf Hinzufügen und wählen Sie dann Neues Projekt.
Erweitern Sie im Dialogfeld Neues Projekt den Punkt Visual C# oder Visual Basic und wählen Sie dann Windows.
Wählen Sie die Projektvorlage WPF-Anwendung.
Geben Sie im Feld Name den Namen AdventureWorksSalesEditor ein und klicken Sie OK.

Visual Studio fügt das Projekt AdventureWorksSalesEditor der Lösung hinzu.
Klicken Sie im Menü Daten auf Datenquellen anzeigen.

Das Datenquellenfenster wird geöffnet.
Klicken Sie im Datenquellenfenster auf Neue Datenquelle hinzufügen.

Der Assistent zum Konfigurieren von Datenquellen wird geöffnet.
Wählen Sie auf der Seite Datenquellentyp auswählen des Assistenten Dienst und klicken Sie auf Weiter.
Klicken Sie im Dialogfeld Dienstverweis hinzufügen auf Ermitteln.

Visual Studio durchsucht die aktuelle Lösung nach verfügbaren Diensten und fügt AdventureWorksService.svc zur Liste verfügbarer Dienste im Feld Dienste hinzu.
Geben Sie im Feld Namespace die Zeichenfolge AdventureWorksService ein.
Geben Sie im Feld Dienste den Namen AdventureWorksService.svc ein und klicken Sie OK.

Visual Studio lädt die Dienstinformation herunter und kehrt dann zum Assistenten zum Konfigurieren von Datenquellen zurück.
Klicken Sie auf der Seite Dienstverweis hinzufügen auf Fertig stellen.

Visual Studio fügt Knoten hinzu, der die vom Dienst zurückgegeben Daten im Datenquellenfenster anzeigt.

Die Benutzeroberfläche des Fensters definieren

Fügen Sie dem Fenster eine Reihe von Schaltflächen hinzu, indem Sie XAML im WPF-Designer ändern. Später in dieser exemplarischen Vorgehensweise fügen Sie dann Code hinzu, mit dem Anwender die Verkaufsdatensätze mithilfe dieser Schaltflächen anzeigen und ändern können.

So erstellen Sie das Fensterlayout

Doppelklicken Sie inProjektmappen-Explorer MainWindow.xaml.

Das Fenster wird automatisch im WPF-Designer geöffnet.

Fügen Sie in der XAML-Ansicht des Designers den folgenden Code zwischen den <Grid>-Tags hinzu:

<Grid.RowDefinitions>
    <RowDefinition Height="75" />
    <RowDefinition Height="525" />
</Grid.RowDefinitions>
<Button HorizontalAlignment="Left" Margin="22,20,0,24" Name="backButton" Width="75">&lt;</Button>
<Button HorizontalAlignment="Left" Margin="116,20,0,24" Name="nextButton" Width="75">&gt;</Button>
<Button HorizontalAlignment="Right" Margin="0,21,46,24" Name="saveButton" Width="110">Save changes</Button>

Erstellen Sie das Projekt.

Erstellen der datengebundenen Steuerelemente

Erstellen Sie Steuerelemente zum Anzeigen der Kundedatensätze, indem Sie den Knoten SalesOrderHeaders vom Datenquellenfenster auf den Designer ziehen.

So erstellen Sie ein datengebundene Steuerelemente

Klicken Sie im Datenquellenfenster das Dropdownmenü für den Knoten SalesOrderHeaders und wählen Sie Details.
Erweitern Sie den Knoten SalesOrderHeaders.
In diesem Beispiel werden einige Felder nicht angezeigt. Klicken Sie also das Dropdownmenü neben den folgenden Knoten und wählen Sie Keine:
- CreditCardApprovalCode
- ModifiedDate
- OnlineOrderFlag
- RevisionNumber
- rowguid
Durch diese Aktion wird Visual Studio daran gehindert, im nächsten Schritt datengebundene Steuerelemente für diese Knoten zu erstellen. Bei dieser exemplarischen Vorgehensweise wird davon ausgegangen, dass der Endbenutzer diese Daten nicht sehen muss.
Ziehen Sie aus dem Datenquellenfenster den Knoten SalesOrderHeaders auf das Raster unter der Zeile, in der die Schaltflächen sind.

Visual Studio erzeugt XAML und Code, der einen Satz von Steuerelementen erstellt, die zu Daten in der Tabelle Product enthalten sind. Weitere Informationen über das generierte XAML und den Code finden Sie unter Binden von WPF-Steuerelementen an Daten in Visual Studio.
Klicken Sie im Designer auf das Textfeld neben der Bezeichnung Customer ID.
Wählen Sie im Fenster Eigenschaften das Kontrollkästchen neben der Eigenschaft IsReadOnly.
Legen Sie die Eigenschaft IsReadOnly für jedes der folgenden Textfelder fest:
- Purchase Order Number
- Sales Order ID
- Sales Order Number

Laden Sie die Daten aus dem Dienst

Verwenden Sie das Dienstproxyobjekt des Diensts und weisen Sie dann die zurückgegeben Daten der Datenquelle für die CollectionViewSource im WPF-Fenster zu.

So laden Sie die Daten aus dem Dienst

Doppelklicken Sie im Designer auf folgenden Text: MainWindow zum Erstellen des Window_Loaded-Ereignishandlers.

Ersetzen Sie den Ereignishandler durch den folgenden Code. Achten Sie darauf, dass Sie die Adresse localhost in diesem Code durch die lokale Hostadresse Ihres Entwicklungscomputers ersetzen.

Private DataServiceClient As AdventureWorksService.AdventureWorksLTEntities
Private SalesQuery As System.Data.Services.Client.DataServiceQuery(Of AdventureWorksService.SalesOrderHeader)
Private OrdersViewSource As CollectionViewSource

Private Sub Window_Loaded(ByVal Sender As Object, ByVal e As RoutedEventArgs) Handles MyBase.Loaded

    ' TODO: Modify the port number in the following URI as required.
    DataServiceClient = New AdventureWorksService.AdventureWorksLTEntities( _
    New Uri("https://localhost:32415/AdventureWorksService.svc"))
    SalesQuery = DataServiceClient.SalesOrderHeaders

    OrdersViewSource = CType(Me.FindResource("SalesOrderHeadersViewSource"), CollectionViewSource)
    OrdersViewSource.Source = SalesQuery.Execute()
    OrdersViewSource.View.MoveCurrentToFirst()
End Sub

private AdventureWorksService.AdventureWorksLTEntities dataServiceClient;
private System.Data.Services.Client.DataServiceQuery<AdventureWorksService.SalesOrderHeader> salesQuery;
private CollectionViewSource ordersViewSource;

private void Window_Loaded(object sender, RoutedEventArgs e)
{
    // TODO: Modify the port number in the following URI as required.
    dataServiceClient = new AdventureWorksService.AdventureWorksLTEntities(
        new Uri("https://localhost:45899/AdventureWorksService.svc"));
    salesQuery = dataServiceClient.SalesOrderHeaders;

    ordersViewSource = ((CollectionViewSource)(this.FindResource("salesOrderHeadersViewSource")));
    ordersViewSource.Source = salesQuery.Execute();
    ordersViewSource.View.MoveCurrentToFirst();
}

Navigieren durch Sales Records

Fügen Sie Code hinzu, mit dessen Hilfe Benutzer durch die Salesdatensätze scrollen können, indem Sie die Schaltflächen < und > verwenden.

Benutzern das Navigieren durch Sales Records ermöglichen

Doppelklicken Sie im Designer die Schaltfläche < auf der Fensteroberfläche.

Visual Studio öffnet die CodeBehind-Datei und erstellt einen neuen backButton_Click-Ereignishandler für das Click-Ereignis.

Fügen Sie dem generierten backButton_Click-Ereignishandler folgenden Code hinzu:

If OrdersViewSource.View.CurrentPosition > 0 Then
    OrdersViewSource.View.MoveCurrentToPrevious()
End If

if (ordersViewSource.View.CurrentPosition > 0)
    ordersViewSource.View.MoveCurrentToPrevious();

Kehren Sie zum Designer zurück und doppelklicken Sie die Schaltfläche >.

Visual Studio öffnet die CodeBehind-Datei und erstellt einen neuen nextButton_Click-Ereignishandler für das Click-Ereignis.

Fügen Sie dem generierten nextButton_Click-Ereignishandler folgenden Code hinzu:

If OrdersViewSource.View.CurrentPosition < CType(OrdersViewSource.View, CollectionView).Count - 1 Then
    OrdersViewSource.View.MoveCurrentToNext()
End If

if (ordersViewSource.View.CurrentPosition < ((CollectionView)ordersViewSource.View).Count - 1)
{
    ordersViewSource.View.MoveCurrentToNext();
}

Änderungen an Sales Records speichern

Fügen Sie Code hinzu, mit dem Benutzer Änderungen an Sales Records sowohl anzeigen als auch mithilfe der Taste Änderungen speichern speichern können.

Die Möglichkeit zum Speichern von Änderungen zu Sales Records hinzufügen

Doppelklicken Sie im Designer auf die Schaltfläche Änderungen speichern.

Visual Studio öffnet die CodeBehind-Datei und erstellt einen neuen saveButton_Click-Ereignishandler für das Click-Ereignis.

Fügen Sie dem saveButton_Click-Ereignishandler den folgenden Code hinzu.

Dim CurrentOrder As AdventureWorksService.SalesOrderHeader = CType(OrdersViewSource.View.CurrentItem, AdventureWorksService.SalesOrderHeader)

DataServiceClient.UpdateObject(CurrentOrder)
DataServiceClient.SaveChanges()

AdventureWorksService.SalesOrderHeader currentOrder = (AdventureWorksService.SalesOrderHeader)ordersViewSource.View.CurrentItem;
dataServiceClient.UpdateObject(currentOrder);
dataServiceClient.SaveChanges();

Testen der Anwendung

Erstellen Sie die Anwendung und führen Sie sie aus; prüfen Sie, ob Sie die Kundendatensätze anzeigen und ändern können.

So testen Sie die Anwendung

Klicken Sie im Menü Build auf Projektmappe erstellen. Überprüfen Sie, ob die Lösung ohne Fehler erstellt wurde.
Drücken Sie STRG+F5.

Visual Studio startet das Projekt AdventureWorksService ohne Debugging.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste das Projekt AdventureWorksSalesEditor.
Klicken Sie im Kontextmenü unter Debug auf Neue Instanz starten.

Die Anwendung wird ausführt. Überprüfen Sie Folgendes:
- Die Textfelder zeigen unterschiedliche Datenfelder aus dem ersten Verkaufsdatensatz an, der die Sales Order ID 71774 hat.
- Sie können die Schaltflächen > oder < für die Navigation durch andere Verkaufsdatensätze klicken.
Geben Sie Text in einen der Verkaufsdatensätze im Feld Comment ein und klicken Sie anschließend Änderungen speichern.
Schließen Sie die Anwendung und starten Sie sie dann erneut aus Visual Studio.
Navigieren Sie zum Verkaufsdatensatz, den Sie geändert haben und überprüfen Sie, dass die Änderung nach dem Schließen und erneut Öffnen noch vorhanden ist.
Schließen Sie die Anwendung.

Nächste Schritte

Nach Abschluss dieser exemplarischen Vorgehensweise können Sie folgende Aufgaben ausführen:

Erfahren Sie, wie Sie das Datenquellenfenster in Visual Studio für die Bindung von WPF-Steuerelementen an andere Typen von Datenquellen verwenden. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Binden von WPF-Steuerelementen an ein Dataset.
Erfahren Sie, wie Sie das Datenquellenfenster in Visual Studio für die Anzeige zugehöriger Daten (das heißt, Daten in einer Beziehung zwischen übergeordneten und untergeordneten Daten) in WPF-Steuerelementen verwenden. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Anzeigen verknüpfter Daten in einer WPF-Anwendung.

Siehe auch