Procedura: aggiungere una query con parametri a un'applicazione Windows Form

È possibile aggiungere funzionalità di ricerca a un form in un'applicazione Windows mediante l'esecuzione di una query con parametri. Una query con parametri restituisce dati che soddisfano le condizioni di una clausola WHERE. Per aggiungere la parametrizzazione a una query, è necessario impostare le opzioni appropriate nella Finestra di dialogo Generatore di criteri per la ricerca. È ad esempio possibile aggiungere un parametro a una query in modo da visualizzare solo i clienti di una determinata città aggiungendo WHERE City = @City alla fine dell'istruzione SQL che restituisce un elenco di clienti. Per ulteriori informazioni, vedere Query con parametri.

Quando si inseriscono dati nella finestra di dialogo Criteri di ricerca, avviene quanto riportato di seguito:

• La query viene aggiunta al TableAdapter associato.

• Vengono aggiunti controlli al form che consentono agli utenti di fornire i valori di parametro richiesti e viene inserito un pulsante per l'esecuzione della query.

• All'evento click del pulsante viene aggiunto del codice per l'impostazione dei valori di parametro e l'esecuzione della query.

Nota

È possibile che le finestre di dialogo e i comandi di menu visualizzati siano diversi da quelli descritti nella Guida a seconda delle impostazioni attive o dell'edizione del programma. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Gestione delle impostazioni.

Per aggiungere una query a un form associato a dati esistente

1. Aprire il form in Progettazione Windows Form.

2. Scegliere Aggiungi query dal menu Dati o in Smart tag dei dati.

   Nota

   Se l'opzione Aggiungi query non è disponibile nel menu Dati, selezionare nel form il controllo che consente di visualizzare l'origine dati a cui si desidera aggiungere la parametrizzazione. Se, ad esempio, nel form i dati sono visualizzati in un controllo DataGridView, selezionare tale controllo. Se i dati del form sono visualizzati in controlli singoli, selezionare qualsiasi controllo associato a dati.

3. Selezionare la tabella desiderata per aggiungere la parametrizzazione nell'area Seleziona tabella origine dati. Per ulteriori informazioni, vedere Finestra di dialogo Generatore di criteri per la ricerca.

4. Digitare un nome nella casella Nuovo nome query se si intende creare una nuova query.

   -oppure-

   Selezionare una query nella casella Nome query esistente.

5. Digitare una query che accetta parametri nella casella Testo della query.

   Suggerimento
   Utilizzare il Generatore di query per ottenere indicazioni sulla creazione di una query. Per ulteriori informazioni, vedere Strumenti di Progettazione query e Progettazione visualizzazioni.

6. Scegliere OK.

   Un controllo per l'immissione del parametro e un pulsante Carica vengono aggiunti al form in un controllo ToolStrip.

Vedere anche

Attività

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

Procedura dettagliata: visualizzazione di dati in un Windows Form

Procedura: connettersi ai dati di un database

Procedura: esplorare i dati con il controllo BindingNavigator Windows Form

Procedura: ordinare e filtrare i dati ADO.NET con il componente BindingSource Windows Form

Procedura: creare una tabella di ricerca con il componente BindingSource di Windows Form

Riferimenti

Origini dati (finestra)

Concetti

Cenni preliminari sugli oggetti TableAdapter

Progettazione DataSet

Cenni preliminari sulle origini dati

Altre risorse

Convalida dei dati