Procedura: creazione di un Windows Form per la ricerca di dati

Articolo
08/11/2011

Uno scenario applicativo comune prevede la visualizzazione dei dati selezionati in un form, ad esempio gli ordini per un determinato cliente o i dettagli di un ordine specifico. In questo scenario un utente immette informazioni in un form, quindi viene eseguita una query che utilizza come parametro l'input dell'utente, vale a dire che i dati vengono selezionati in base a una query con parametri. La query restituisce solo i dati che soddisfano i criteri immessi dall'utente. In questa procedura dettagliata viene illustrato come creare una query che restituisca i clienti di una determinata città e come modificare l'interfaccia utente in modo che gli utenti possano immettere il nome di una città e premere un pulsante per eseguire la query.

L'utilizzo di query con parametri consente un funzionamento più efficiente dell'applicazione, permettendo al database l'esecuzione ottimale delle operazioni di filtro rapido dei record. La richiesta invece di un'intera tabella del database, il relativo trasferimento in rete e l'utilizzo della logica dell'applicazione per trovare i record desiderati possono comportare una riduzione della velocità e dell'efficienza dell'applicazione.

È possibile aggiungere query con parametri a qualsiasi oggetto TableAdapter (e controlli in modo che vengano accettati valori di parametri e venga eseguita la query) mediante la Finestra di dialogo Generatore di criteri per la ricerca. Aprire la finestra di dialogo selezionando il comando Aggiungi query dal menu Dati o da qualsiasi smart tag di TableAdapter.

Di seguito sono elencate le attività illustrate nella procedura dettagliata:

Creazione di un nuovo progetto Applicazione Windows.
Creazione e configurazione dell'origine dati nell'applicazione con la Configurazione guidata origine dati.
Impostazione del tipo di visualizzazione degli elementi nella Origini dati (finestra). Per ulteriori informazioni, vedere Procedura: impostare il controllo da creare per il trascinamento dalla finestra Origini dati.
Creazione di controlli per la visualizzazione dei dati mediante il trascinamento di elementi dalla finestra Origini dati in un form.
Aggiunta di controlli per la visualizzazione dei dati nel form.
Inserimento dei dati mancanti nella Finestra di dialogo Generatore di criteri per la ricerca.
Inserimento dei parametri nel form ed esecuzione della query con parametri.

Prerequisiti

Per completare questa procedura dettagliata, è necessario quanto segue:

Accedere al database di esempio Northwind. Per ulteriori informazioni, vedere Procedura: installare database di esempio.

Creazione dell'applicazione Windows

Il primo passaggio consiste nella creazione di un'Applicazione Windows. Sebbene in questo passaggio l'assegnazione di un nome al progetto sia facoltativa, il nome verrà assegnato comunque in quanto si desidera salvare il progetto successivamente.

Per creare il nuovo progetto Applicazione Windows

Scegliere il comando per la creazione di un nuovo progetto dal menu File.
Assegnare al progetto il nome WindowsSearchForm.
Selezionare Applicazione Windows e scegliere OK. Per ulteriori informazioni, vedere Creazione di applicazioni per Windows.

Il progetto WindowsSearchForm verrà creato e aggiunto a Esplora soluzioni.

Creazione dell'origine dati

Nel corso di questo passaggio verrà creata un'origine dati da un database utilizzando la Configurazione guidata origine dati. Per creare la connessione è necessario disporre di accesso al database di esempio Northwind. Per informazioni sull'impostazione del database di esempio Northwind, vedere Procedura: installare database di esempio.

Per creare l'origine dati

Scegliere Mostra origini dati dal menu Dati.
Nella finestra Origini dati selezionare Aggiungi nuova origine dati per avviare la Configurazione guidata origine dati.
Selezionare Database nella pagina Scegliere un tipo di origine dati e scegliere Avanti.
Nella pagina Seleziona connessione dati effettuare una delle seguenti operazioni:
- Selezionare la connessione dati al database di esempio Northwind nell'elenco a discesa, se presente.
  
  - oppure -
- Selezionare Nuova connessione per aprire la finestra di dialogo Aggiungi/Modifica connessione. Per ulteriori informazioni, vedere Finestra di dialogo Aggiungi/Modifica connessione (generale).
Se il database in uso richiede una password, selezionare l'opzione che consente di includere dati riservati, quindi scegliere Avanti.
Scegliere Avanti nella pagina Salva la stringa di connessione nel file di configurazione dell'applicazione.
Espandere il nodo Tabelle nella pagina Seleziona oggetti di database.
Selezionare la tabella Customers, quindi scegliere Fine.

Il dataset NorthwindDataSet viene aggiunto al progetto e la tabella Customers viene visualizzata nella finestra Origini dati.

Creazione del form

È possibile creare i controlli con associazione a dati mediante il trascinamento degli elementi dalla finestra Origini dati al form.

Per creare controlli con associazione a dati nel form

Espandere il nodo Customers nella finestra Origini dati.
Trascinare il nodo Customers dalla finestra Origini dati nel form.

Sul form vengono visualizzati un oggetto DataGridView e un controllo Toolstrip (BindingNavigator) per lo spostamento all'interno dei record. Sulla barra dei componenti vengono visualizzati gli oggetti NorthwindDataSet, CustomersTableAdapter BindingSource e BindingNavigator.

Aggiunta della parametrizzazione (funzionalità di ricerca) alla query

È possibile aggiungere una clausola WHERE alla query originale utilizzando la Finestra di dialogo Generatore di criteri per la ricerca.

Per creare una query con parametri e controlli per l'immissione dei parametri

Selezionare il controllo DataGridView, quindi scegliere Aggiungi query dal menu Dati.
Digitare FillByCity nell'area Nuovo nome query della Finestra di dialogo Generatore di criteri per la ricerca.
Aggiungere WHERE City = @City alla query nell'area Testo della query.

La query dovrebbe essere simile a quella riportata di seguito:

SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax

FROM Customers

WHERE City = @City

Nota

Nelle origini dati Access e OleDb viene utilizzato il punto interrogativo (?) per indicare i parametri, pertanto la clausola WHERE risulterebbe simile a WHERE City = ?.
Fare clic su OK per chiudere la finestra di dialogo Generatore di criteri per la ricerca.

Al form viene aggiunto un FillByCityToolStrip.

Verifica dell'applicazione

Quando l'applicazione viene eseguita, il form viene aperto ed è pronto ad accettare il parametro come input.

Per eseguire il test dell'applicazione

‎Premere F5 per eseguire l'applicazione.
Digitare London nella casella di testo City, quindi fare clic su FillByCity.

La griglia dei dati viene popolata con i clienti che soddisfano i criteri di parametrizzazione. In questo esempio nella griglia dei dati vengono visualizzati solo i clienti nella cui colonna City è presente un valore London.

Passaggi successivi

A seconda dei requisiti dell'applicazione, si potranno eseguire diverse operazioni una volta terminata la creazione di un form con parametri. È tuttavia possibile apportare alcuni miglioramenti a questa procedura dettagliata, tra cui:

Aggiunta di controlli per la visualizzazione dei dati correlati. Per ulteriori informazioni, vedere Procedura: visualizzare dati correlati in un'applicazione Windows Form.
Modifica del dataset per aggiungere o rimuovere oggetti di database. Per ulteriori informazioni, vedere Procedura: modificare un dataset.

Vedere anche

Condividi tramite