Procedura: esecuzione di query TableAdapter

Articolo
09/12/2015

Le query TableAdapter sono istruzioni SQL oppure stored procedure e possono essere eseguite dall'applicazione in uso su un database ed esposte come metodi tipizzati sul TableAdapter. È possibile eseguire le query TableAdapter mediante la chiamata ai metodi associati, in modo identico a qualsiasi altro metodo su un qualsiasi oggetto.

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

Creazione di un'istanza del TableAdapter

Prima che sia possibile effettuare la chiamata a uno dei metodi TableAdapter, è necessario creare un'istanza del TableAdapter.

Nota

I TableAdapter vengono creati e modificati tramite Progettazione Dataset; tuttavia, in realtà non rappresentano classi annidate all'interno di un dataset.I TableAdapter sono collocati all'interno di uno spazio dei nomi identificato in base al nome del dataset associato al TableAdapter.La convenzione di denominazione è: NomeDataSet + "TableAdapters".Ad esempio, tutti i TableAdapter associati al NorthwindDataSet saranno collocati nello spazio dei nomi di NorthwindDataSetTableAdapters.Se è presente un CustomersTableAdapter, il relativo nome completo sarà NorthwindDataSetTableAdapters.CustomersTableAdapter.

Per creare un'istanza del TableAdapter

Trascinare gli elementi dalla finestra Origini dati in un form nell'applicazione Windows in uso per creare in modo automatico un'istanza di un TableAdapter nel form. Esaminare il TableAdapter nella barra dei componenti (l'area di piccole dimensioni sotto il bordo inferiore del form) per il nome dell'istanza.

In alternativa
Dopo aver creato un TableAdapter, compilare il progetto. Il TableAdapter viene quindi visualizzato nella Casella degli strumenti. Trascinare il TableAdapter dalla Casella degli strumenti a un form per creare un'istanza. Esaminare il TableAdapter nella barra dei componenti per il nome dell'istanza.

In alternativa

Creare un'istanza di TableAdapter a livello di codice:

Dim CustomersTableAdapter1 As NorthwindDataSetTableAdapters.CustomersTableAdapter
CustomersTableAdapter1 = New NorthwindDataSetTableAdapters.CustomersTableAdapter()

NorthwindDataSetTableAdapters.CustomersTableAdapter customersTableAdapter1;
customersTableAdapter1 = new NorthwindDataSetTableAdapters.CustomersTableAdapter();

Esecuzione di query TableAdapter che riempiono tabelle dati esistenti (metodi Fill())

Per eseguire una query TableAdapter che riempie una tabella dati esistente

Chiamare la query Fill oppure FillBy di TableAdapter e passarla nella tabella dati da riempire. Ad esempio, il codice riportato di seguito consente di eseguire la query Fill e di riempire la tabella Customers.
```
CustomersTableAdapter1.Fill(NorthwindDataSet1.Customers)
```
```
customersTableAdapter1.Fill(northwindDataSet1.Customers);
```

Esecuzione di query TableAdapter che restituiscono nuove tabelle dati (metodi GetData())

Per eseguire una query TableAdapter che restituisce una nuova tabella dati

Chiamare la query GetData oppure GetDataBy di TableAdapter per restituire una tabella dati tipizzata con i risultati della query. Ad esempio, il codice riportato di seguito consente di eseguire la query GetData e di restituire una tabella Customers.
```
Dim newCustomersTable As NorthwindDataSet.CustomersDataTable
newCustomersTable = CustomersTableAdapter1.GetData()
```
```
NorthwindDataSet.CustomersDataTable newCustomersTable;
newCustomersTable = customersTableAdapter1.GetData();
```

Esecuzione di query TableAdapter che restituiscono valori singoli (scalari)

È possibile trascinare una query dalla Casella degli strumenti direttamente nella finestra Progettazione Dataset per creare una query autonoma (senza alcuna tabella dati).

Per eseguire una query TableAdapter che restituisce un valore singolo (scalare)

Creare un'istanza del TableAdapter, dichiarare una variabile per mantenere il valore restituito e assegnare a questa il risultato della query. Nell'esempio riportato di seguito si presuppone la presenza di una query denominata CustomerCount nel QueriesTableAdapter.

Dim scalarQueriesTableAdapter As NorthwindDataSetTableAdapters.QueriesTableAdapter
scalarQueriesTableAdapter = New NorthwindDataSetTableAdapters.QueriesTableAdapter()

Dim returnValue As Integer
returnValue = CType(scalarQueriesTableAdapter.CustomerCount(), Integer)

NorthwindDataSetTableAdapters.QueriesTableAdapter scalarQueriesTableAdapter;
scalarQueriesTableAdapter = new NorthwindDataSetTableAdapters.QueriesTableAdapter();

int returnValue;
returnValue = (int)scalarQueriesTableAdapter.CustomerCount();