Procedura: creazione di un Windows Form per la ricerca di dati
Data di pubblicazione: aprile 2016
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 usa come parametro l'input dell'utente. Questo significa 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. Questa procedura dettagliata illustra 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 fare clic su un pulsante per eseguire la query.
L'uso di query con parametri rende più efficiente il funzionamento dell'applicazione, consentendo al database di eseguire in modo ottimale le operazioni di filtro rapido dei record. La richiesta invece di un'intera tabella del database, il relativo trasferimento in rete e l'uso 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. Per aprire la finestra di dialogo, scegliere Aggiungi query nel menu Dati o da qualsiasi smart tag di TableAdapter.
Le attività illustrate nella procedura dettagliata sono le seguenti:
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 altre informazioni, vedere Impostare il controllo da creare durante 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.
Immissione dei parametri nel form ed esecuzione della query con parametri.
Prerequisiti
Per completare questa procedura dettagliata, è necessario:
- Accedere al database di esempio Northwind. Per altre informazioni, vedere Procedura: installare database di esempio.
Creazione dell'applicazione Windows
Il primo passaggio consiste nella creazione di un'applicazione Windows. L'assegnazione di un nome al progetto è facoltativa in questo passaggio, ma al progetto verrà ugualmente assegnato un nome per poterlo salvare in seguito.
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 fare clic su OK. Per altre informazioni, vedere Applicazioni client.
Il progetto WindowsSearchForm viene creato e aggiunto a Esplora soluzioni.
Creazione dell'origine dati
Questo passaggio consente di creare un'origine dati da un database usando la Configurazione guidata origine dati. Per creare la connessione, è necessario avere 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 eseguire una delle operazioni seguenti:
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.
Se il database in uso richiede una password, selezionare l'opzione che consente di includere dati riservati, quindi scegliere Avanti.
Nella pagina Salva stringa di connessione nel file di configurazione dell'applicazione fare clic su Avanti.
Espandere il nodo Tabelle nella pagina Seleziona oggetti di database.
Selezionare la tabella Customers, quindi fare clic su Fine.
L'oggetto NorthwindDataSet viene aggiunto al progetto e la tabella Customers viene visualizzata nella finestra Origini dati.
Creazione del form
È possibile creare i controlli associati a dati trascinando elementi dalla finestra Origini dati nel form.
Per creare controlli associati a dati nel form
Espandere il nodo Customers nella finestra Origini dati.
Trascinare il nodo Customers dalla finestra Origini dati al form.
Sul form vengono visualizzati un oggetto DataGridView e un controllo Toolstrip (BindingNavigator) per lo spostamento all'interno dei record. Nella 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 usando 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 e 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 alla seguente:
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 usato il punto interrogativo (?) per indicare i parametri, quindi 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 elemento 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. È possibile apportare alcuni miglioramenti a questa procedura dettagliata, tra cui:
Aggiunta di controlli per la visualizzazione di dati correlati. Per altre informazioni, vedere Procedura: visualizzare dati correlati in un'applicazione Windows Form.
Modifica del set di dati per aggiungere o rimuovere oggetti di database. Per altre informazioni, vedere Procedura: modificare un dataset.
Vedere anche
Procedure dettagliate relative ai dati
Associazione di controlli Windows Form ai dati in Visual Studio
Cenni preliminari sulle origini dati
Cenni preliminari sugli oggetti TableAdapter
Cenni preliminari sul componente BindingSource
Cenni preliminari sul controllo BindingNavigator