Procedura: creare query TableAdapter

Articolo
03/05/2013

Le query TableAdapter sono istruzioni SQL oppure stored procedure che possono essere eseguite dall'applicazione in uso su un database.

È possibile aggiungere a un TableAdapter tante query quante sono necessarie per l'applicazione.Le query TableAdapter vengono visualizzate su un TableAdapter come metodi.Quando viene creata una query denominata FillByCity che utilizza un parametro che rappresenta il valore relativo alla città, la query viene aggiunta all'oggetto TableAdaptercome metodo tipizzato che accetta il tipo corretto di parametro come argomento, in questo caso una stringa che rappresenta il valore per la città.La query TableAdapter viene chiamata come qualsiasi metodo su qualunque oggetto.Ad esempio, il codice riportato di seguito consente di eseguire la query FillByCity e di riempire la tabella Customers con tutti i clienti che per città hanno il valore Seattle:

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)

string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

Le query TableAdapter consentono di riempire una tabella di dati (query Fill e FillBy) oppure di restituire nuove tabelle di dati compilate con i dati restituiti dalla query (query GetData e GetDataBy).

È possibile aggiungere query ai TableAdapter mediante l'esecuzione della TableAdapter (query, configurazione guidata).Fare clic con il pulsante destro del mouse su un oggetto TableAdapter qualsiasi e scegliere Aggiungi query.

[!NOTA]

Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Creazione di una query nella finestra Progettazione DataSet

Per aggiungere una query a un TableAdapter nella finestra Progettazione DataSet

Aprire un dataset in Progettazione DataSet.Per ulteriori informazioni, vedere Procedura: aprire un dataset in Progettazione DataSet.
Fare clic con il pulsante destro del mouse sul TableAdapter desiderato e selezionare Aggiungi query.

In alternativa
Trascinare un oggetto Query dalla scheda DataSet della Casella degli strumenti su una tabella nella finestra di progettazione.

Viene aperta la Configurazione guidata query TableAdapter.
Completare la procedura guidata. La query verrà aggiunta al TableAdapter.

Creazione di una query direttamente in un form dell'applicazione Windows in uso

Se il form contiene un'istanza di un oggetto TableAdapter, è possibile aggiungere una query mediante la Finestra di dialogo Generatore di criteri per la ricerca, che consente di aggiungere al form un controllo ToolStrip che accetta qualsiasi parametro di input richiesto dalla query, oltre a un pulsante per eseguire la query.

Per aggiungere una query a un TableAdapter mediante la finestra di dialogo Generatore di criteri per la ricerca

Selezionare un oggetto TableAdapter nella barra dei componenti.
Fare clic sullo smart tag del TableAdapter, quindi scegliere Aggiungi query.
Compilare la finestra di dialogo e la query verrà aggiunta al TableAdapter.Per ulteriori informazioni, vedere Finestra di dialogo Generatore di criteri per la ricerca.