Procedura dettagliata: associazione di controlli WPF a un servizio dati WCF

In questa procedura dettagliata, verrà creata un'applicazione WPF contenente i controlli associati a dati. I controlli vengono associati a record cliente incapsulati in un'istanza di WCF Data Services. Verranno inoltre aggiunti i pulsanti che i clienti possono usare per visualizzare e aggiornare i record.

In questa procedura dettagliata vengono illustrate le attività seguenti:

• Creazione di un modello Entity Data Model generato dai dati nel database di esempio AdventureWorksLT.

• Creazione di un'istanza di WCF Data Services che espone i dati del modello Entity Data Model in un'applicazione WPF.

• Creazione di un set di controlli associati a dati mediante il trascinamento di elementi dalla finestra Origini dati in WPF Designer.

• Creazione di pulsanti per spostarsi avanti e indietro tra i record cliente.

• Creazione di un pulsante che consente di salvare le modifiche apportate ai dati dei controlli nell'istanza di WCF Data Services e nell'origine dati sottostante.

  Nota

  Nomi o percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni vedere Personalizzazione delle impostazioni di sviluppo in Visual Studio.

Prerequisiti

Per completare la procedura dettagliata, è necessario disporre dei componenti seguenti:

• Visual Studio

• Accesso a un'istanza in esecuzione di SQL Server o SQL Server Express con il database di esempio AdventureWorksLT associato. È possibile scaricare il database AdventureWorksLT dal sito Web CodePlex.

Per completare la procedura dettagliata è inoltre consigliabile conoscere già i concetti seguenti:

• WCF Data Services. Per altre informazioni, vedere Cenni preliminari su WCF Data Services.

• Modelli di dati in WCF Data Services.

• Modelli di Entity Data Model e ADO.NET Entity Framework. Per altre informazioni, vedere Panoramica su Entity Framework.

• Uso di WPF Designer. Per altre informazioni, vedere WPF Designer Overview.

• Data binding WPF. Per altre informazioni, vedere Cenni preliminari sull'associazione dati.

Creazione del progetto di servizio

Avviare la procedura dettagliata creando un progetto per un'istanza di WCF Data Services.

Per creare il progetto di servizio

1. Avviare Visual Studio.

2. Scegliere Nuovo dal menu File, quindi fare clic su Progetto.

3. Espandere Visual C# o Visual Basic, quindi selezionare Web.

4. Selezionare il modello di progetto Applicazione Web ASP.NET.

5. Nella casella Nome digitare AdventureWorksService e fare clic su OK.

   Visual Studio crea il progetto AdventureWorksService.

6. In Esplora soluzioni fare clic con il pulsante destro del mouse su Default.aspx e scegliere Elimina. Questo file non è necessario per la procedura dettagliata.

Creazione di un modello Entity Data Model per il servizio

Per esporre i dati in un'applicazione usando un'istanza di WCF Data Services, è necessario definire un modello di dati per il servizio. WCF Data Services supporta due tipi di modelli di dati: i modelli Entity Data Model e i modelli di dati personalizzati definiti mediante gli oggetti CLR (Common Language Runtime) che implementano l'interfaccia IQueryable. In questa procedura dettagliata, viene creato un modello Entity Data Model per il modello di dati.

Per creare un modello Entity Data Model

1. Nel menu Progetto fare clic su Aggiungi nuovo elemento.

2. Nell'elenco Modelli installati fare clic su Dati, quindi selezionare l'elemento di progetto ADO.NET Entity Data Model.

3. Modificare il nome in AdventureWorksModel.edmx, e fare clic su Aggiungi.

   Verrà aperta la Procedura guidata Entity Data Model.

4. Nella pagina Scegli contenuto del modello fare clic su Genera da database, quindi su Avanti.

5. Nella pagina Seleziona connessione dati selezionare una delle opzioni seguenti:

   • Selezionare la connessione dati al database di esempio AdventureWorksLT nell'elenco a discesa, se presente.

     -oppure-

   • Fare clic su Nuova connessione e creare una connessione al database AdventureWorksLT.

6. Nella pagina Seleziona connessione dati verificare che l'opzione Salva impostazioni di connessione entità in App.Config come sia selezionata, quindi fare clic su Avanti.

7. Nella pagina Seleziona oggetti di database espandere Tabelle, quindi selezionare la tabella SalesOrderHeader.

8. Scegliere Fine.

Creazione del servizio

Creare un'istanza di WCF Data Services per esporre i dati del modello Entity Data Model in un'applicazione WPF.

Per creare il servizio

1. Scegliere Aggiungi nuovo elementodal menu Progetto.

2. Nell'elenco Modelli installati fare clic su Web, quindi selezionare l'elemento di progetto WCF Data Services.

3. Nella casella Nome digitare AdventureWorksService.svc e fare clic su Aggiungi.

   Visual Studio aggiunge il file AdventureWorksService.svc al progetto.

Configurazione del servizio

È necessario configurare il servizio in modo da usare il modello Entity Data Model creato.

Per configurare il servizio

1. Nel file di codice AdventureWorks.svc sostituire la dichiarazione di classe AdventureWorksService con il codice seguente.

   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);
       }
   }
   

   Questo codice aggiorna la classe AdventureWorksService in modo che derivi da un oggetto DataService che usa la classe di contesto dell'oggetto AdventureWorksLTEntities nel modello Entity Data Model. Aggiorna inoltre il metodo InitializeService per consentire ai client del servizio l'accesso completo in lettura/scrittura all'entità SalesOrderHeader.

2. Compilare il progetto e verificare che non siano presenti errori.

Creazione dell'applicazione client WPF

Per visualizzare i dati di WCF Data Services, creare una nuova applicazione WPF con un'origine dati basata sul servizio. Più avanti in questa procedura dettagliata, verranno aggiunti all'applicazione i controlli associati a dati.

Per creare l'applicazione client WPF

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo della soluzione, scegliere Aggiungi e selezionare Nuovo progetto.

2. Nella finestra di dialogo Nuovo progetto espandere Visual C# o Visual Basic, quindi selezionare Finestre.

3. Selezionare il modello di progetto Applicazione WPF.

4. Nella casella Nome digitare AdventureWorksSalesEditor e fare clic su OK.

   Visual Studio aggiunge il progetto AdventureWorksSalesEditor alla soluzione.

5. Scegliere Mostra origini dati dal menu Dati.

   Verrà visualizzata la finestra Origini dati.

6. Nella finestra Origini dati fare clic su Aggiungi nuova origine dati.

   Verrà avviata la Configurazione guidata origine dati.

7. Nella pagina Seleziona un tipo di origine dati della procedura guidata selezionare Servizio, quindi fare clic su Avanti.

8. Nella finestra di dialogo Aggiungi riferimento al servizio fare clic su Individua.

   Visual Studio cerca i servizi disponibili nella soluzione corrente e aggiunge AdventureWorksService.svc all'elenco dei servizi disponibili nella casella Servizi.

9. Nella casella Spazio dei nomi digitare AdventureWorksService.

10. Nella casella Servizi fare clic su AdventureWorksService.svc, quindi su OK.

    Visual Studio scarica le informazioni sul servizio, quindi torna alla Configurazione guidata origine dati.

11. Nella pagina Aggiungi riferimento al servizio fare clic su Fine.

    Visual Studio aggiunge i nodi che rappresentano i dati restituiti dal servizio nella finestra Origini dati.

Definizione dell'interfaccia utente della finestra

Aggiungere alcuni pulsanti alla finestra modificando il codice XAML in WPF Designer. Più avanti in questa procedura dettagliata, verrà aggiunto il codice che consente agli utenti di visualizzare e aggiornare i record delle vendite tramite questi pulsanti.

Per creare il layout della finestra

1. In Esplora soluzioni fare doppio clic su MainWindow.xaml.

   La finestra verrà aperta in WPF Designer.

2. Nella visualizzazione XAML della finestra di progettazione aggiungere il codice seguente tra i tag <Grid>:

   <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>
   

3. Compilare il progetto.

Creazione dei controlli associati a dati

Creare i controlli che consentono di visualizzare i record cliente trascinando il nodo SalesOrderHeaders dalla finestra Origini dati alla finestra di progettazione.

Per creare i controlli associati a dati

1. Nella finestra Origini dati fare clic sul menu a discesa del nodo SalesOrderHeaders e selezionare Dettagli.

2. Espandere il nodo SalesOrderHeaders.

3. Poiché per questo esempio alcuni campi non verranno visualizzati, fare clic sul menu a discesa accanto ai nodi seguenti e selezionare Nessuno:

   • CreditCardApprovalCode

   • ModifiedDate

   • OnlineOrderFlag

   • RevisionNumber

   • rowguid

   Questa azione impedisce a Visual Studio di creare i controlli associati a dati per questi nodi nel passaggio successivo. Per questa procedura dettagliata, si presume che l'utente finale non debba visualizzare questi dati.

4. Dalla finestra Origini dati trascinare il nodo SalesOrderHeaders nella riga della griglia sotto la riga contenente i pulsanti.

   Visual Studio genera l'XAML e il codice che crea un set di controlli associati a dati nella tabella Product. Per altre informazioni sull'XAML e il codice generati, vedere Associazione di controlli WPF ai dati in Visual Studio.

5. Nella finestra di progettazione fare clic sulla casella di testo accanto all'etichetta Customer ID.

6. Nella finestra Proprietà selezionare la casella di controllo accanto alla proprietà IsReadOnly.

7. Impostare la proprietà IsReadOnly per ognuna delle caselle di testo seguenti:

   • Purchase Order Number

   • Sales Order ID

   • Sales Order Number

Caricamento dei dati dal servizio

Usare l'oggetto proxy del servizio per caricare i dati delle vendite dal servizio, quindi assegnare i dati restituiti all'origine dati per l'oggetto CollectionViewSource nella finestra WPF.

Per caricare i dati dal servizio

1. Nella finestra di progettazione fare doppio clic sul testo MainWindow per creare il gestore eventi Window_Loaded.

2. Sostituire il gestore eventi con il codice seguente. Assicurarsi di sostituire l'indirizzo localhost in questo codice con l'indirizzo dell'host locale nel computer di sviluppo.

   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();
   }
   

Esplorazione dei record delle vendite

Aggiungere il codice che consente agli utenti di scorrere i record delle vendite usando i pulsanti < e >.

Per consentire agli utenti di esplorare i record delle vendite

1. Nella finestra di progettazione fare doppio clic sul pulsante < nell'area della finestra.

   Visual Studio apre il file code-behind e crea un nuovo gestore eventi backButton_Click per l'evento Click.

2. Aggiungere il codice seguente al gestore eventi backButton_Click generato:

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

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

3. Tornare alla finestra di progettazione e fare doppio clic sul pulsante >.

   Visual Studio apre il file code-behind e crea un nuovo gestore eventi nextButton_Click per l'evento Click.

4. Aggiungere il codice seguente al gestore eventi nextButton_Click generato:

   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();
   }
   

Salvataggio delle modifiche ai record delle vendite

Aggiungere il codice che consente agli utenti di visualizzare e salvare le modifiche ai record delle vendite usando il pulsante Salva modifiche.

Per aggiungere la possibilità di salvare le modifiche ai record delle vendite

1. Nella finestra di progettazione fare doppio clic sul pulsante Salva modifiche.

   Visual Studio apre il file code-behind e crea un nuovo gestore eventi saveButton_Click per l'evento Click.

2. Aggiungere il codice seguente al gestore eventi saveButton_Click.

   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();
   

Verifica dell'applicazione

Compilare ed eseguire l'applicazione per verificare che sia possibile visualizzare e aggiornare i record cliente.

Per eseguire il test dell'applicazione

1. Nel menu Compila fare clic su Compila soluzione. Verificare che la soluzione venga compilata senza errori.

2. Premere CTRL+F5.

   Visual Studio avvia il progetto AdventureWorksService senza eseguirne il debug.

3. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto AdventureWorksSalesEditor.

4. Scegliere Debug dal menu di scelta rapida, quindi Avvia nuova istanza.

   Verrà eseguita l'applicazione. Verificare quanto segue:

   • Nelle caselle di testo vengono visualizzati campi di dati diversi dal primo record di vendite il cui ID ordine vendite è 71774.

   • È possibile fare clic sui pulsanti > o < per spostarsi tra gli altri record delle vendite.

5. In uno dei record delle vendite digitare del testo nella casella Commento, quindi fare clic su Salva modifiche.

6. Chiudere l'applicazione, quindi avviarla di nuovo da Visual Studio.

7. Passare al record delle vendite modificato e verificare che la modifica sia presente dopo avere chiuso e riaperto l'applicazione.

8. Chiudere l'applicazione.

Passaggi successivi

Dopo avere completato questa procedura dettagliata, è possibile eseguire le attività correlate seguenti:

• Imparare a usare la finestra Origini dati in Visual Studio per associare i controlli WPF ad altri tipi di origini dati. Per altre informazioni, vedere Procedura dettagliata: associazione di controlli WPF a un dataset.

• Imparare a usare la finestra Origini dati in Visual Studio per visualizzare i dati correlati, ovvero i dati in una relazione padre-figlio, nei controlli WPF. Per altre informazioni, vedere Procedura dettagliata: visualizzazione dei dati correlati in un'applicazione WPF.

Vedere anche

Attività

Procedura: associare controlli WPF ai dati in Visual Studio

Procedura dettagliata: associazione di controlli WPF a un dataset

Concetti

Associazione di controlli WPF ai dati in Visual Studio

Cenni preliminari su WCF Data Services

Panoramica su Entity Framework

Cenni preliminari sull'associazione dati

Altre risorse

WPF Designer Overview