Share via

Procedura dettagliata: creazione di un form per la ricerca di dati in un'applicazione Windows

  • Articolo

Aggiornamento: novembre 2007

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:

Prerequisiti

Per completare questa procedura dettagliata, è necessario:

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, si procederà comunque alla specifica di un nome in quanto è previsto che il progetto venga salvato in un secondo momento.

Per creare il nuovo progetto Applicazione Windows

  1. Scegliere il comando per la creazione di un nuovo progetto dal menu File.

  2. Assegnare al progetto il nome WindowsSearchForm.

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

  1. Scegliere Mostra origini dati dal menu Dati.

  2. Nella finestra Origini dati selezionare Aggiungi nuova origine dati per avviare la Configurazione guidata origine dati.

  3. Selezionare Database nella pagina Seleziona un tipo di origine dati, quindi scegliere Avanti.

  4. Nella pagina Seleziona connessione dati effettuare una delle seguenti operazioni:

    • Se nell'elenco a discesa è disponibile una connessione dati al database di esempio Northwind, selezionarla.

      - oppure -

    • Selezionare Nuova connessione per aprire la finestra di dialogo Aggiungi/Modifica connessione. Per ulteriori informazioni, vedere Finestra di dialogo Aggiungi/Modifica connessione (generale).

  5. Se il database in uso richiede una password, selezionare l'opzione che consente di includere dati riservati, quindi scegliere Avanti.

  6. Scegliere Avanti nella pagina Salvare la stringa di connessione nel file di configurazione dell'applicazione.

  7. Espandere il nodo Tabelle nella pagina Seleziona oggetti di database.

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

  1. Espandere il nodo Customers nella finestra Origini dati.

  2. 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, CustomersTableAdapterBindingSource 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

  1. Selezionare il controllo DataGridView, quindi scegliere Aggiungi query dal menu Dati.

  2. Digitare FillByCity nell'area Nuovo nome query della Finestra di dialogo Generatore di criteri per la ricerca.

  3. 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 = ?.

  4. Fare clic su OK per chiudere la finestra di dialogo Generatore di criteri per la ricerca.

    Al form viene aggiunto un FillByCityToolStrip.

Test 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

  1. ‎Premere F5 per eseguire l'applicazione.

  2. 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:

Vedere anche

Concetti

Novità relative ai dati

Cenni preliminari sulla visualizzazione dei dati

Cenni preliminari sulle origini dati

Cenni preliminari sugli oggetti TableAdapter

Riferimenti

Cenni preliminari sul componente BindingSource

Cenni preliminari sul controllo BindingNavigator (Windows Form)

Altre risorse

Procedure dettagliate relative ai dati