Condividi tramite

Creare un Windows Form di .NET Framework per cercare i dati con ADO.NET

Annotazioni

La DataSet classe e le classi correlate sono tecnologie .NET Framework legacy dei primi anni '2000 che consentono alle applicazioni di lavorare con i dati in memoria mentre le app vengono disconnesse dal database. Le tecnologie sono particolarmente utili per le app che consentono agli utenti di modificare i dati e rendere persistenti le modifiche apportate al database. Sebbene i set di dati siano una tecnologia di successo comprovata, l'approccio consigliato per le nuove applicazioni .NET consiste nell'usare Entity Framework Core. Entity Framework offre un modo più naturale per usare i dati tabulari come modelli a oggetti e dispone di un'interfaccia di programmazione più semplice.

Uno scenario di applicazione comune consiste nel visualizzare i dati selezionati in un modulo. Ad esempio, potrebbe essere necessario visualizzare gli ordini per un cliente specifico o i dettagli di un ordine specifico. In questo scenario, un utente immette le informazioni in un modulo e quindi viene eseguita una query con l'input dell'utente come parametro; ovvero, 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 restituisce i clienti in una città specifica e 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'uso di query con parametri consente di rendere efficiente l'applicazione consentendo al database di svolgere il lavoro ottimale, filtrando rapidamente i record. Al contrario, se si richiede un'intera tabella di database, trasferirla in rete e quindi usare la logica dell'applicazione per trovare i record desiderati, l'applicazione può diventare lenta e inefficiente.

È possibile aggiungere query con parametri a qualsiasi TableAdapter (e controlli per accettare i valori dei parametri ed eseguire la query), usando la finestra di dialogo Generatore criteri di ricerca . Aprire la finestra di dialogo selezionando il comando Aggiungi query dal menu Dati (o in uno smart tag TableAdapter).

Le attività illustrate in questa procedura dettagliata includono:

  • Creazione e configurazione dell'origine dati nell'applicazione con la configurazione guidata origine dati .

  • Impostazione del tipo di eliminazione degli elementi nella finestra Origini dati .

  • Creazione di controlli che visualizzano i dati trascinando gli elementi dalla finestra Origini dati in un modulo.

  • Aggiunta di controlli per visualizzare i dati nel form.

  • Completamento della finestra di dialogo Generatore criteri di ricerca .

  • Immissione di parametri nel modulo ed esecuzione della query con parametri.

Annotazioni

Le procedure descritte in questo articolo si applicano solo ai progetti Windows Form di .NET Framework, non ai progetti Windows Form .NET Core.

Prerequisiti

È necessario che sia installato il carico di Archiviazione e elaborazione dati. Consulta per modificare Visual Studio.

Questa procedura dettagliata usa SQL Server Express LocalDB e il database di esempio Northwind.

  1. Se SQL Server Express LocalDB non è disponibile, installarlo dalla pagina di download di SQL Server Express o tramite il programma di installazione di Visual Studio. Nel programma di installazione di Visual Studioè possibile installare SQL Server Express LocalDB come parte del carico di lavoro di archiviazione ed elaborazione dei dati o come singolo componente.

  2. Installare il database di esempio Northwind seguendo questa procedura:

    1. In Visual Studio, aprire la finestra Esplora oggetti di SQL Server. L'Esplora oggetti di SQL Server è installato come parte del carico di lavoro Archiviazione dati ed elaborazione nel programma di installazione di Visual Studio. Espandi il nodo SQL Server. Fare clic con il pulsante destro del mouse sull'istanza di LocalDB e selezionare Nuova query.

      Verrà visualizzata una finestra dell'editor di query.

    2. Copia lo script Northwind Transact-SQL negli Appunti. Questo script T-SQL crea il database Northwind da zero e lo popola con i dati.

    3. Incolla lo script T-SQL nell'editor di query e poi scegli il pulsante Esegui.

      Dopo un breve periodo di tempo, la query termina l'esecuzione e viene creato il database Northwind.

Creare l'applicazione Windows Form

Creare un nuovo progetto app Windows Forms (.NET Framework) per C# o Visual Basic. Assegnare al progetto il nome WindowsSearchForm.

Creare l'origine dati

Questo passaggio crea un'origine dati da un database usando la configurazione guidata origine dati :

  1. Per aprire la finestra Origini dati , usare la ricerca rapida (CTRL+Q) e cercare Origini dati.

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

  3. Selezionare Database nella pagina Scegliere un tipo di origine dati e quindi selezionare Avanti.

  4. Nella schermata Scegliere un modello di database scegliere Set di dati e quindi selezionare Avanti.

  5. Nella pagina Scelta connessione dati eseguire una delle operazioni seguenti:

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

    • Selezionare Nuova connessione per avviare la finestra di dialogo Aggiungi/Modifica connessione .

  6. Nella pagina Salva stringa di connessione nel file di configurazione dell'applicazione fare clic su Avanti.

  7. Nella pagina Scegliere gli oggetti di database espandere il nodo Tabelle .

  8. Selezionare la tabella Customers (Clienti ) e quindi selezionare Finish (Fine).

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

Creare il modulo

È possibile creare i controlli associati a dati trascinando gli elementi dalla finestra Origini dati nel form:

  1. Verificare che la finestra di progettazione Windows Forms abbia lo stato attivo e che la finestra Origini dati sia aperta e bloccata.

  2. Espandere il nodo Clienti nella finestra Origini dati .

  3. Trascinare il nodo Customers dalla finestra Origini dati al form.

    Nel modulo DataGridView vengono visualizzati un elemento e una striscia di strumenti (BindingNavigator) per lo spostamento dei record. Un oggetto NorthwindDataSet, CustomersTableAdapter, BindingSourcee BindingNavigator viene visualizzato nella barra dei componenti.

Aggiungere parametrizzazione (funzionalità di ricerca) alla query

È possibile aggiungere una WHERE clausola alla query originale usando la finestra di dialogo Generatore criteri di ricerca :

  1. Proprio sotto l'area di progettazione del modulo, selezionare il pulsante customersTableAdapter e quindi nella finestra Proprietà scegliere Aggiungi query....

  2. Digitare FillByCity nell'area Nuovo nome query nella finestra di dialogo Generatore criteri di ricerca .

  3. Aggiungi WHERE City = @City alla query nell'area del 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

    Annotazioni

    L'accesso e le origini dati OLE DB usano il punto interrogativo ('?') per indicare i parametri, quindi la WHERE clausola sarà simile alla seguente: WHERE City = ?.

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

    Viene aggiunto un FillByCityToolStrip al form.

Testare l'applicazione

L'esecuzione dell'applicazione apre il modulo e lo rende pronto per accettare il parametro come input:

  1. Premere F5 per eseguire l'applicazione.

  2. Digitare Londra nella casella di testo City e quindi selezionare FillByCity.

    La griglia dei dati viene popolata con i clienti che soddisfano i criteri. In questo esempio la griglia dati visualizza solo i clienti che hanno un valore di Londra nella colonna City .

Passaggi successivi

A seconda dei requisiti dell'applicazione, è possibile eseguire diversi passaggi dopo la creazione di un modulo con parametri. È possibile apportare alcuni miglioramenti a questa procedura dettagliata, tra cui:

Contenuti correlati