Procedura dettagliata: applicazione basata su query con parametri

Articolo
09/12/2008

Aggiornamento: novembre 2007

In questa procedura dettagliata viene illustrato come utilizzare l'ambiente Visual Studio per sviluppare una semplice applicazione basata su query con parametri. L'associazione dati e gran parte dell'interfaccia utente verranno generate automaticamente. Questa applicazione, basata sul familiare database Northwind, è appropriata per scenari in cui gli utenti di dispositivi Smart Device devono determinare il valore di Shipping Country sapendo solo il valore di Order Number. Le applicazioni compilate tramite questa procedura consentono agli utenti di immettere il valore di Order Number e di visualizzare il valore di Shipping Country corrispondente.

Nota:
Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Questa procedura dettagliata è stata scritta utilizzando Impostazioni di sviluppo di Visual Basic e Impostazioni di sviluppo di Visual C#.

Prerequisiti

Database Northwind per SQL Server Compact 3.5, incluso in Visual Studio.

Nota:
Se non si dispone dei diritti di amministratore nel computer di sviluppo, non è possibile aprire il file Northwind.sdf dal percorso predefinito, ovvero unità:\Programmi\Microsoft SQL Server Compact Edition\v3.5\Samples. Copiare il file nel computer desktop o in Documenti e aprirlo da tale percorso, quando richiesto.

Scelta di un dispositivo di destinazione

Per assicurarsi che venga chiesto di selezionare un dispositivo al momento della distribuzione della soluzione, attenersi alla procedura che segue.

Per visualizzare un elenco di dispositivi in fase di distribuzione

Scegliere Opzioni dal menu Strumenti, espandere Strumenti dispositivo, quindi fare clic su Generale.
Selezionare la casella di controllo Mostra opzioni dispositivi prima di distribuire un progetto per dispositivo.

Creazione dell'applicazione

Questa è una semplice applicazione Windows Form nella quale verrà inserita la funzionalità di questa procedura dettagliata.

Per creare un progetto per un dispositivo Windows Form

(Visual Basic) Scegliere Nuovo progetto dal menu File di Visual Studio.

oppure

(Visual C#) Scegliere Nuovo dal menu File di Visual Studio, quindi fare clic su Progetto.
Nel riquadro Tipi progetto espandere Visual Basic o Visual C#, fare clic su Smart Device, fare clic su Progetto Smart Device nel riquadro Modelli, digitare ParamQuerySample nella casella Nome, quindi scegliere OK.
Nella finestra di dialogo Aggiungi nuovo progetto Smart Device selezionare Pocket PC 2003 nell'elenco a discesa Piattaforma di destinazione, fare clic su Applicazione dispositivo, quindi scegliere OK.

In Progettazione Windows Form verrà visualizzata una rappresentazione di un dispositivo Pocket PC.

Aggiunta di funzionalità dati

In questa sezione verranno illustrate le seguenti operazioni:

Selezione di un tipo di origine dati.
Selezione e configurazione di una connessione dati.
Selezione di oggetti di database.
Aggiunta nel form di controlli con associazione a dati.

Per selezionare un tipo di origine dati

Dal menu Dati scegliere Aggiungi nuova origine dati per aprire la Configurazione guidata origine dati.
Nella pagina Seleziona un tipo di origine dati fare clic su Database, quindi su Avanti.

Per selezionare e configurare una connessione dati

Nella pagina Seleziona connessione dati fare clic su Nuova connessione.

Nella finestra di dialogo Scegli origine dati selezionare Microsoft SQL Server Compact 3.5, quindi fare clic su Continua.

Nota:
È possibile che, in base alle impostazioni e ai progetti precedenti, venga visualizzata la finestra di dialogo Aggiungi connessione invece della finestra di dialogo Scegli origine dati. In questo caso, scegliere Cambia nella finestra di dialogo Aggiungi connessione per aprire la finestra di dialogo Modifica origine dati. Selezionare quindi Microsoft SQL Server Compact 3.5 e scegliere OK.

Nella finestra di dialogo Aggiungi connessione selezionare Risorse del computer.
Nella finestra di dialogo Aggiungi connessione fare clic su Sfoglia.
Nella finestra di dialogo Seleziona file di database SQL Server Compact 3.5 selezionare Northwind.sdf, quindi scegliere Apri.
Nella finestra di dialogo Aggiungi connessione lasciare vuota la casella Password.

Questo database non ha una password.

Nota sulla sicurezza:

Per i database utilizzati in applicazioni reali, utilizzare una password complessa.

Nota sulla sicurezza:
Per i database utilizzati in applicazioni reali, utilizzare una password complessa.

Scegliere Test connessione per verificare la connessione.

Nota:
Se viene negato l'accesso al file Northwind.sdf, copiarlo sul desktop e, dopo averlo individuato, aprirne la copia. Questa situazione può verificarsi se non si dispone di diritti sufficienti sul computer di sviluppo per aprire il file nel percorso predefinito, indicato all'inizio di questa procedura dettagliata.

Fare clic su OK nella finestra del messaggio che informa della riuscita connessione, quindi fare clic su OK per chiudere la finestra di dialogo Aggiungi connessione.
Nella pagina Seleziona connessione dati fare clic su Avanti.
Nella finestra del messaggio in cui viene chiesto se si desidera copiare il file nel progetto, scegliere Sì.

Per selezionare oggetti di database

Nella pagina Seleziona oggetti di database espandere il nodo Tabelle, quindi selezionare la tabella Orders.
Fare clic su Fine.

Viene creato NorthwindDataset. È possibile visualizzare questa origine dati scegliendo Mostra origini dati dal menu Dati.

Per creare la query

Espandere la tabella Orders nella finestra Origini dati.
Fare clic sulla colonna Ship Country, quindi sulla freccia a discesa, infine selezionare l'opzione Label.
Trascinare la colonna Ship Country sul form nella finestra di progettazione.
Nel controllo Label nella finestra di progettazione fare clic sullo smart tag, quindi scegliere Aggiungi query dal menu di scelta rapida.
Nella finestra di dialogo Generatore di criteri per la ricerca scegliere Generatore di query.
Nella colonna Filter della riga Order ID digitare un punto interrogativo (?).

Questo simbolo indica che gli utenti dell'applicazione dovranno inserire un valore per l'ID dell'ordine.
Scegliere OK.

La clausola WHERE nella casella Testo della query verrà ora visualizzata come ([Order ID]=@PARAM1).
Fare clic su OK per chiudere la finestra di dialogo Generatore di criteri per la ricerca.

Nel form nella finestra di progettazione verrà visualizzato un pannello.

Per perfezionare l'interfaccia utente

Fare clic con il pulsante destro del mouse sul controllo Label PARAM1 nella finestra di progettazione, quindi scegliere Proprietà.

oppure

Nella finestra Proprietà selezionare il controllo Param1Label.
Modificare la proprietà Text in Order ID.
Selezionare il pulsante FillBy, quindi modificarne la proprietà Text in Show country.
Espandere il pannello e i controlli per eliminare le barre di scorrimento e visualizzare tutto il testo. Controllare soprattutto che Ship_CountryLabel e la relativa casella di testo non siano nascoste dietro a FillByPanel e ai relativi controlli.

Test dell'applicazione

In questa sezione l'applicazione verrà compilata, quindi verrà scaricata sull'emulatore di Pocket PC 2003 SE e ne verrà verificato il corretto funzionamento.

Per eseguire il test dell'applicazione

Scegliere Avvia o Avvia debug dal menu Debug.
Nella finestra di dialogo Distribuisci selezionare Emulatore SE Pocket PC 2000, quindi scegliere Distribuisci.

Nella barra di stato è indicato lo stato di avanzamento della distribuzione. La distribuzione all'emulatore può richiedere tempo.
Quando l'applicazione è in esecuzione nell'emulatore, digitare un numero d'ordine del database Northwind, compreso tra 10000 e 11077, quindi scegliere Show country.

Nel controllo Label verrà visualizzato il valore di Ship Country corrispondente all'ordine specificato.

Preparazione per procedure dettagliate supplementari

Se si prevede di eseguire ulteriori procedure dettagliate o di aprire altri progetti, chiudere l'emulatore e uscire dalla soluzione.

Per chiudere l'emulatore e la soluzione

Scegliere Esci dal menu File dell'emulatore.
Nella finestra del messaggio Emulatore di dispositivo scegliere No in risposta al messaggio che richiede di salvare lo stato dell'emulatore.
(Visual Basic) Scegliere Chiudi progetto dal menu File.

—oppure—

(Visual C#) Scegliere Chiudi soluzione dal menu File.

Se viene richiesto di salvare il progetto o la soluzione, scegliere Salva per riutilizzare il progetto o la soluzione in seguito oppure Cancella se non si desidera salvare i file.

Vedere anche

Condividi tramite