Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Mit WCF Data Services können Sie Silverlight-Steuerelemente wie ListBox oder ComboBox an eine Instanz von DataServiceCollection<T> binden. Diese Klasse behandelt die von den Steuerelementen ausgelösten Ereignisse, um den DataServiceContext mit an Daten in den Steuerelementen vorgenommenen Änderungen synchron zu halten. Eine DataServiceCollection<T> wird basierend auf einer DataServiceQuery<TElement> definiert. Sobald diese Abfrage ausgeführt wird, gibt sie einen Open Data Protocol (OData)-Feed zurück, der die Objekte für die Auflistung bereitstellt.
Die Verfahren in diesem Thema beschreiben die folgenden Aufgaben:
(Optional) Aktivieren der Pagingfunktionalität im Northwind-Datendienst.
Erstellen einer neuen Silverlight-Anwendung.
Generieren von Clientdatendienstklassen, die automatische Datenbindung unterstützen.
Abfragen des Datendiensts.
Binden der Ergebnisse an Steuerelemente in der Anwendung.
Verwenden Sie eine CollectionViewSource-Instanz, um das Binden der Master- und Detail-Objekte Order und Order_Detail zu vereinfachen. Legen Sie hierfür die Source-Eigenschaft von CollectionViewSource auf die Master-DataServiceCollection<T> fest. Die Datenbindung von Steuerelementen wird im XAML so definiert, dass Änderungen der ausgewählten Order zu einer Änderung der angezeigten Order_Details führen, wenn die Auflistung geladen wird. Weitere Informationen finden Sie unter How to: Bind to Hierarchical Data and Create a Master/Details View.
Hinweis
Die CollectionViewSource-Klasse wird in Silverlight 3 nicht unterstützt.
Dieses Beispiel zeigt, wie Sie einen OData-Feed binden, wenn Paging im Datendienst aktiviert wurde. Das Paging eines Datenfeeds wird von Version 2.0 des OData-Protokolls und höheren Versionen unterstützt.
Der Northwind-Beispieldatendienst, auf den die Anwendung zugreift, wird erstellt, wenn Sie den WCF Data Services-Schnellstart abschließen. Sie können auch den öffentlichen Northwind-Beispieldatendienst auf der OData-Website verwenden. Dieser Beispieldatendienst ist schreibgeschützt. Wenn Sie versuchen, Änderungen zu speichern, wird ein Fehler zurückgegeben.
So aktivieren Sie die Pagingfunktionalität im Northwind-Datendienst
Doppelklicken Sie im Projektmappen-Explorer unter dem ASP.NET-Projekt auf die Datei "Northwind.svc".
Die Codeseite für den Northwind-Beispieldatendienst wird geöffnet.
Fügen Sie im Code für den Datendienst folgenden Code zur InitializeService-Methode hinzu:
' Set the data service version to V2 to support paging. config.DataServiceBehavior.MaxProtocolVersion = _ System.Data.Services.Common.DataServiceProtocolVersion.V2 ' Set paging limits for the Customers and Orders entity sets. ' These limits are set very low to demonstrate paging with the ' Northwind database. Paging should be configured to optimize ' data service performance. config.SetEntitySetPageSize("Orders", 2) config.SetEntitySetPageSize("Order_Details", 2)// Set the data service version to V2 to support paging. config.DataServiceBehavior.MaxProtocolVersion = System.Data.Services.Common.DataServiceProtocolVersion.V2; // Set paging limits for the Customers and Orders entity sets. // These limits are set very low to demonstrate paging with the // Northwind database. Paging should be configured to optimize // data service performance. config.SetEntitySetPageSize("Orders", 2); config.SetEntitySetPageSize("Order_Details", 2);Dadurch wird das Paging für die Entitätenmengen Orders und Order_Details aktiviert.
So erstellen Sie die Anwendung für das Silverlight-Projekt
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Projektmappe, zeigen Sie auf Hinzufügen, und wählen Sie anschließend Neues Projekt aus.
Wählen Sie im Dialogfeld Neues Projekt hinzufügen im Bereich Kategorien die Kategorie Silverlight aus, und wählen Sie dann die Vorlage Silverlight-Anwendung. Geben Sie für das Projekt den Namen DataBindingSample ein.
Wählen Sie im Dialogfeld Silverlight-Anwendung hinzufügen die Option Die Silverlight-Anwendung in einer neuen oder bestehenden Website in der Lösung hosten. Wählen Sie Testseite hinzufügen, die auf die Anwendung verweist und Als Startseite festlegen aus.
Klicken Sie auf OK.
Die Anwendung für Silverlight wird erstellt.
So fügen Sie dem Projekt einen Datendienstverweis hinzu
Klicken Sie mit der rechten Maustaste auf das DataBindingSample-Projekt, klicken Sie auf Dienstverweis hinzufügen und dann auf Ermitteln.
Dadurch wird der Northwind-Datendienst angezeigt, den Sie in der ersten Aufgabe erstellt haben.
Geben Sie im Textfeld Namespace Northwind ein, und klicken Sie auf OK.
Dadurch wird dem Projekt, das die zum Zugriff auf und zur Interaktion mit Datendienstressourcen als Objekte verwendeten Datenklassen enthält, eine neue Codedatei hinzugefügt. Die Datenklassen werden im Namespace DataBindingSample.Northwind erstellt.
So definieren Sie die Benutzeroberfläche der Clientanwendung
Klicken Sie im Projektmappen-Explorer unter DataBindingSample mit der rechten Maustaste auf Verweise, und klicken Sie dann auf Verweis hinzufügen.
Dadurch wird das Dialogfeld Verweis hinzufügen angezeigt.
Wählen Sie System.Windows.Controls.Data aus, und klicken Sie auf OK.
Doppelklicken Sie im Projektmappen-Explorer auf die Datei "MainPage.xaml". Das XAML-Markup für die Page-Klasse, die die Benutzeroberfläche der Silverlight-Anwendung darstellt, wird geöffnet.
Ersetzen Sie das vorhandene XAML-Markup durch folgendes Markup, das die Benutzeroberfläche der Clientanwendung definiert:
<!-- NOTE: By convention, the sdk prefix indicates a URI-based XAML namespace declaration for Silverlight SDK client libraries. This namespace declaration is valid for Silverlight 4 only. In Silverlight 3, you must use individual XAML namespace declarations for each CLR assembly and namespace combination outside the scope of the default Silverlight XAML namespace. For more information, see the help topic "Prefixes and Mappings for Silverlight Libraries". --> <UserControl x:Class="MainPage" xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:sdk="https://schemas.microsoft.com/winfx/2006/xaml/presentation/sdk" xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml" Loaded="MainPage_Loaded" mc:Ignorable="d" xmlns:d="https://schemas.microsoft.com/expression/blend/2008" xmlns:mc="https://schemas.openxmlformats.org/markup-compatibility/2006" xmlns:my="clr-namespace:DataBindingSample.Northwind" d:DesignHeight="371" d:DesignWidth="0"> <UserControl.Resources> <CollectionViewSource x:Key="OrdersViewSource" d:DesignSource="{d:DesignInstance my:Order, CreateList=True}" /> <CollectionViewSource x:Key="OrdersOrder_DetailsViewSource" Source="{Binding Path=Order_Details, Source={StaticResource OrdersViewSource}}" /> </UserControl.Resources> <StackPanel Orientation="Vertical" Margin="10" Height="Auto" Name="LayoutRoot" Width="450"> <StackPanel Orientation="Horizontal"> <sdk:Label Content="Customer ID:"/> <TextBox Name="customerId" Text="ALFKI" Margin="10" Width="100"/> <Button Name="getCustomerOrders" Content="Get Orders" Height="25" Width="80" Click="getCustomerOrders_Click" /> </StackPanel> <StackPanel Name="ordersStackPanel" VerticalAlignment="Top" Orientation="Vertical" DataContext="{StaticResource OrdersViewSource}"> <Grid HorizontalAlignment="Left" Name="ordersGrid" VerticalAlignment="Top"> <Grid.ColumnDefinitions> <ColumnDefinition Width="Auto" /> <ColumnDefinition Width="Auto" /> <ColumnDefinition Width="Auto" /> <ColumnDefinition Width="Auto" /> <ColumnDefinition Width="Auto" /> <ColumnDefinition Width="Auto" /> </Grid.ColumnDefinitions> <Grid.RowDefinitions> <RowDefinition Height="Auto" /> <RowDefinition Height="Auto" /> <RowDefinition Height="Auto" /> </Grid.RowDefinitions> <sdk:Label Content="Order:" Grid.Column="0" Grid.Row="0" HorizontalAlignment="Left" Margin="3" VerticalAlignment="Center" /> <ComboBox DisplayMemberPath="OrderID" Grid.Column="1" Grid.Row="0" Height="23" HorizontalAlignment="Left" ItemsSource="{Binding}" Margin="3" Name="OrderIDComboBox" VerticalAlignment="Center" Width="120" SelectionChanged="ordersList_SelectionChanged"> <ComboBox.ItemsPanel> <ItemsPanelTemplate> <VirtualizingStackPanel /> </ItemsPanelTemplate> </ComboBox.ItemsPanel> </ComboBox> <sdk:Label Content="Freight:" Grid.Column="2" Grid.Row="0" HorizontalAlignment="Left" Margin="3" VerticalAlignment="Center" /> <TextBox Grid.Column="3" Grid.Row="0" Height="23" HorizontalAlignment="Left" Margin="3" Name="FreightTextBox" Text="{Binding Path=Freight, Mode=TwoWay, ValidatesOnExceptions=true, NotifyOnValidationError=true}" VerticalAlignment="Center" Width="120" /> <sdk:Label Content="Required Date:" Grid.Column="0" Grid.Row="1" HorizontalAlignment="Left" Margin="3" VerticalAlignment="Center" /> <sdk:DatePicker Grid.Column="1" Grid.Row="1" Height="23" HorizontalAlignment="Left" Margin="3" Name="RequiredDateDatePicker" SelectedDate="{Binding Path=RequiredDate, Mode=TwoWay, ValidatesOnExceptions=true, NotifyOnValidationError=true}" VerticalAlignment="Center" Width="120" /> <sdk:Label Content="Order Date:" Grid.Column="2" Grid.Row="1" HorizontalAlignment="Left" Margin="3" VerticalAlignment="Center" /> <TextBox Grid.Column="3" Grid.Row="1" Height="23" HorizontalAlignment="Left" Width="120" Margin="3" Name="OrderDateTextBlock" Text="{Binding Path=OrderDate}" VerticalAlignment="Center" /> </Grid> </StackPanel> <StackPanel DataContext="{StaticResource OrdersOrder_DetailsViewSource}" Orientation="Vertical"> <sdk:Label Content="Order items:" Margin="10"/> <sdk:DataGrid AutoGenerateColumns="False" Height="170" ItemsSource="{Binding}" Name="Order_DetailsDataGrid" RowDetailsVisibilityMode="VisibleWhenSelected" Width="400"> <sdk:DataGrid.Columns> <sdk:DataGridTextColumn x:Name="ProductIDColumn" Binding="{Binding Path=ProductID}" Header="Product" Width="SizeToHeader" /> <sdk:DataGridTextColumn x:Name="QuantityColumn" Binding="{Binding Path=Quantity}" Header="Quantity" Width="SizeToHeader" /> <sdk:DataGridTextColumn x:Name="DiscountColumn" Binding="{Binding Path=Discount}" Header="Discount" Width="SizeToHeader" /> <sdk:DataGridTextColumn x:Name="UnitPriceColumn" Binding="{Binding Path=UnitPrice}" Header="Unit Price" Width="SizeToHeader" /> </sdk:DataGrid.Columns> </sdk:DataGrid> </StackPanel> <Button Name="saveChangesButton" Content="Save Changes" HorizontalAlignment="Right" Click="saveChangesButton_Click" Width="100" Height="25" Margin="10"/> </StackPanel> </UserControl>Hinweis
Bei einer C#-Anwendung müssen Sie im Class-Attribut von UserControl den Namespace mit angeben.Der Standardnamespace ist bei einer Visual Basic-Anwendung nicht erforderlich.
So fügen Sie in der Silverlight-Anwendung Code hinzu, der Datendienstdaten an Steuerelemente bindet
Öffnen Sie im Projektmappen-Explorer unter DataBindingSample die Codepage für die Datei "MainPage.xaml", und fügen Sie die folgende using-Anweisung (Imports in Visual Basic) hinzu.
using System.Windows.Data; using System.Data.Services.Client; using DataBindingSample.Northwind;Fügen Sie der MainPage-Klasse die folgenden Deklarationen hinzu:
Dim context As NorthwindEntities Dim trackedOrders As DataServiceCollection(Of Order) Dim selectedOrder As Order Dim ordersViewSource As CollectionViewSourceNorthwindEntities context; DataServiceCollection<Order> trackedOrders; Order selectedOrder; CollectionViewSource ordersViewSource;Fügen Sie der MainPage-Klasse die MainPage_Loaded-Methode hinzu:
Private Sub MainPage_Loaded(ByVal sender As Object, ByVal e As RoutedEventArgs) ' Initialize the data service context. context = _ New NorthwindEntities(New Uri("https://localhost:54321/Northwind.svc")) ' Initialize the binding and view source collections. trackedOrders = New DataServiceCollection(Of Order)() ordersViewSource = CType(Me.Resources("OrdersViewSource"), CollectionViewSource) ' Define a handler for the LoadCompleted event of the collection. AddHandler trackedOrders.LoadCompleted, _ AddressOf trackedOrders_LoadCompleted End Subprivate void MainPage_Loaded(object sender, RoutedEventArgs e) { // Initialize the data service context. context = new NorthwindEntities(new Uri("Northwind.svc", UriKind.Relative)); // Initialize the binding and view source collections. trackedOrders = new DataServiceCollection<Order>(); ordersViewSource = (CollectionViewSource)this.Resources["OrdersViewSource"]; // Define a handler for the LoadCompleted event of the binding collection. trackedOrders.LoadCompleted += new EventHandler<LoadCompletedEventArgs>(trackedOrders_LoadCompleted); }Wenn die Seite geladen wird, initialisiert dieser Code die Bindungsauflistungen und den Inhalt und registriert die Methode, mit der das von der Bindungsauflistung ausgelöste LoadCompleted-Ereignis behandelt wird.
Fügen Sie folgenden Code in die MainPage-Klasse ein:
Private Sub getCustomerOrders_Click(ByVal sender As Object, _ ByVal e As RoutedEventArgs) ' Define a query that returns orders for a give customer. Dim query = From orderByCustomer In context.Orders _ Where orderByCustomer.Customer.CustomerID = _ Me.customerId.Text _ Select orderByCustomer ' Asynchronously load the result of the query. trackedOrders.LoadAsync(query) ' Disable the button until the loading is complete. getCustomerOrders.IsEnabled = False End Sub Private Sub trackedOrders_LoadCompleted(ByVal sender As Object, _ ByVal e As LoadCompletedEventArgs) If e.Error Is Nothing Then ' Load all pages of Orders before binding. If trackedOrders.Continuation IsNot Nothing Then trackedOrders.LoadNextPartialSetAsync() Else ' Bind the root StackPanel element to the collection ' related object binding paths are defined in the XAML. ordersViewSource.Source = trackedOrders ' Re-enable the button since the loading is complete. getCustomerOrders.IsEnabled = True End If Else MessageBox.Show(String.Format("An error has occured: {0}", e.Error.Message)) getCustomerOrders.IsEnabled = True End If End Subprivate void getCustomerOrders_Click(object sender, RoutedEventArgs e) { // Reset the grids. ordersViewSource.Source = null; // Define a query that returns orders for a give customer. var query = from orderByCustomer in context.Orders where orderByCustomer.Customer.CustomerID == this.customerId.Text select orderByCustomer; // Asynchronously load the result of the query. trackedOrders.LoadAsync(query); // Disable the button until the loading is complete. getCustomerOrders.IsEnabled = false; } private void trackedOrders_LoadCompleted(object sender, LoadCompletedEventArgs e) { if (e.Error == null) { // Load all pages of Orders before binding. if (trackedOrders.Continuation != null) { trackedOrders.LoadNextPartialSetAsync(); } else { // Bind the root StackPanel element to the collection; // related object binding paths are defined in the XAML. ordersViewSource.Source = trackedOrders; // Re-enable the button since the loading is complete. getCustomerOrders.IsEnabled = true; } } else { MessageBox.Show(string.Format("An error has occured: {0}",e.Error.Message)); getCustomerOrders.IsEnabled = true; } }Wenn auf die getCustomerOrders-Schaltfläche geklickt wird, werden die folgenden Vorgänge ausgeführt:
Die LoadAsync-Methode der Bindungsauflistung wird aufgerufen, um die angegebene Abfrage auszuführen, die Bestellungen, gefiltert nach der angegebenen Kunden-ID, zurückgibt.
Die LoadNextPartialSetAsync-Methode wird aufgerufen, um so lange nachfolgende Ergebnisseiten zu laden, wie die Continuation-Eigenschaft einen Wert zurückgibt.
Die Auflistung geladener Order-Objekte ist an die Source-Eigenschaft von CollectionViewSource gebunden. Dies ist das Masterauflistungsobjekt für alle Steuerelemente auf der Seite.
Fügen Sie folgenden Code in die MainPage-Klasse ein:
Private Sub ordersList_SelectionChanged(ByVal sender As Object, _ ByVal e As SelectionChangedEventArgs) ' Get the selected Order in the DataGrid. Dim ordersList As ComboBox = CType(sender, ComboBox) selectedOrder = CType(ordersList.SelectedItem, Order) If Not selectedOrder Is Nothing Then ' Asynchronously load related items, if they are not already loaded. If selectedOrder.Order_Details.Count = 0 Then ' Register the method to handle the LoadCompleted event. AddHandler selectedOrder.Order_Details.LoadCompleted, _ AddressOf Order_Details_LoadCompleted Try ' Load the related items. selectedOrder.Order_Details.LoadAsync() Catch ex As InvalidOperationException MessageBox.Show(String.Format("An error has occured: {0}", _ ex.Message)) End Try End If End If End Sub Private Sub Order_Details_LoadCompleted(ByVal sender As Object, _ ByVal e As LoadCompletedEventArgs) Dim trackedItems As DataServiceCollection(Of Order_Detail) = _ CType(sender, DataServiceCollection(Of Order_Detail)) ' Load any remaining pages of Order_Details. If Not trackedItems.Continuation Is Nothing Then Try trackedItems.LoadNextPartialSetAsync() Catch ex As InvalidOperationException MessageBox.Show(String.Format("An error has occured: {0}", _ ex.Message)) End Try End If End Subprivate void ordersList_SelectionChanged(object sender, SelectionChangedEventArgs e) { // Get the selected Order in the DataGrid. ComboBox ordersList = sender as ComboBox; selectedOrder = ((Order)(ordersList.SelectedItem)); if (selectedOrder != null) { // Asynchronously load related items, if they are not already loaded. if (selectedOrder.Order_Details.Count == 0) { // Register the method to handle the LoadCompleted event. selectedOrder.Order_Details.LoadCompleted += new EventHandler<LoadCompletedEventArgs>( Order_Details_LoadCompleted); try { // Load the related items. selectedOrder.Order_Details.LoadAsync(); } catch (InvalidOperationException ex) { MessageBox.Show(string.Format("An error has occured: {0}", ex.Message)); } } } } void Order_Details_LoadCompleted(object sender, LoadCompletedEventArgs e) { DataServiceCollection<Order_Detail> trackedItems = sender as DataServiceCollection<Order_Detail>; // Load any remaining pages of Order_Details. if (trackedItems.Continuation != null) { try { trackedItems.LoadNextPartialSetAsync(); } catch (InvalidOperationException ex) { MessageBox.Show(string.Format("An error has occured: {0}", ex.Message)); } } }Die ordersList_SelectionChanged-Methode behandelt das SelectionChanged-Ereignis. Wenn der Benutzer eine Bestellung in ComboBox auswählt, werden die folgenden Vorgänge ausgeführt:
Die Order_Details_LoadCompleted-Methode wird registriert, um das LoadCompleted-Ereignis zu behandeln, das von der DataServiceCollection<T> ausgelöst wird, die die zugehörigen Elemente für die ausgewählte Bestellung darstellt.
Die LoadAsync-Methode wird aufgerufen, um asynchron die zugehörigen Order_Details-Objekte für die Order zu laden, die in ComboBox ausgewählt wurde.
Die LoadNextPartialSetAsync-Methode wird aufgerufen, um so lange nachfolgende Ergebnisseiten zu laden, wie die Continuation-Eigenschaft einen Wert zurückgibt.
Die geladenen Elemente werden von der untergeordneten CollectionViewSource an das DataGrid weitergegeben.
Fügen Sie den folgenden Code zum Speichern von Änderungen in der MainPage-Klasse hinzu:
' We need to persist the result of an operation ' to be able to invoke the dispatcher. Private currentResult As IAsyncResult Private Sub saveChangesButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs) ' Define the delegate to callback into the process Dim callback As AsyncCallback = AddressOf OnChangesSaved Try ' Start the saving changes operation. This needs to be a ' batch operation in case we are added a new object with ' a new relationship. context.BeginSaveChanges(SaveChangesOptions.Batch, _ callback, context) Catch ex As Exception MessageBox.Show(String.Format( _ "The changes could not be saved to the data service.\n" _ & "The following error occurred: {0}", ex.Message)) End Try End Sub Private Sub OnChangesSaved(ByVal result As IAsyncResult) ' Persist the result for the delegate. currentResult = result ' Use the Dispatcher to ensure that the ' asynchronous call returns in the correct thread. Dispatcher.BeginInvoke(AddressOf ChangesSavedByDispatcher) End Sub Private Sub ChangesSavedByDispatcher() Dim errorOccured As Boolean = False context = CType(currentResult.AsyncState, NorthwindEntities) Try ' Complete the save changes operation and display the response. Dim response As DataServiceResponse = _ context.EndSaveChanges(currentResult) For Each changeResponse As ChangeOperationResponse In response If changeResponse.Error IsNot Nothing Then errorOccured = True Next If Not errorOccured Then MessageBox.Show("The changes have been saved to the data service.") Else MessageBox.Show("An error occured. One or more changes could not be saved.") End If Catch ex As Exception ' Display the error from the response. MessageBox.Show(String.Format("The following error occured: {0}", ex.Message)) End Try End Subprivate void saveChangesButton_Click(object sender, RoutedEventArgs e) { try { // Start the saving changes operation. This needs to be a // batch operation in case we are added a new object with // a new relationship. context.BeginSaveChanges(SaveChangesOptions.Batch, OnChangesSaved, context); } catch (Exception ex) { MessageBox.Show(string.Format("The changes could not be saved to the data service.\n" + "The following error occurred: {0}", ex.Message)); } } private void OnChangesSaved(IAsyncResult result) { bool errorOccured = false; // Use the Dispatcher to ensure that the // asynchronous call returns in the correct thread. Dispatcher.BeginInvoke(() => { context = result.AsyncState as NorthwindEntities; try { // Complete the save changes operation and display the response. DataServiceResponse response = context.EndSaveChanges(result); foreach (ChangeOperationResponse changeResponse in response) { if (changeResponse.Error != null) errorOccured = true; } if (!errorOccured) { MessageBox.Show("The changes have been saved to the data service."); } else { MessageBox.Show("An error occured. One or more changes could not be saved."); } } catch (Exception ex) { // Display the error from the response. MessageBox.Show(string.Format("The following error occured: {0}", ex.Message)); } } ); }Dieser Code sendet Änderungen in den datengebundenen Steuerelementen asynchron zurück an den Datendienst.
Siehe auch
Andere Ressourcen
WCF Data Services-Schnellstart für Silverlight
WCF Data Services (Silverlight)
WCF Data Services Tasks for Silverlight