Procedura: creare ed eseguire un'istruzione SQL che restituisce righe

Articolo
08/11/2011

Per eseguire un'istruzione SQL che restituisca delle righe, è possibile utilizzare una query TableAdapter configurata in modo da eseguire un'istruzione SQL, come ad esempio CustomersTableAdapter.Fill(CustomersDataTable).

Se nell'applicazione non vengono utilizzati TableAdapter, chiamare il metodo ExecuteReader su un oggetto comando impostandone la proprietà CommandType su Text. Per oggetto comando si intende il comando specifico del Provider di dati .NET Framework utilizzato dall'applicazione. Se, ad esempio, è in uso il Provider di dati .NET Framework per SQL Server, l'oggetto comando sarà SqlCommand.

Negli esempi riportati di seguito viene illustrato come eseguire istruzioni SQL che restituiscono righe da un database mediante TableAdapter o oggetti comando. Per ulteriori informazioni sull'esecuzione di query con TableAdapter e comandi, vedere Inserimento di dati nei dataset.

Esecuzione di istruzioni SQL che restituiscono righe mediante un TableAdapter

In questo esempio viene illustrato come creare una query TableAdapter mediante la TableAdapter (query, configurazione guidata) e vengono fornite informazioni sulle modalità di dichiarazione di un'istanza di TableAdapter e di 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 creare un'istruzione SQL che restituisce righe mediante un TableAdapter

Aprire un dataset in Progettazione DataSet. Per ulteriori informazioni, vedere Procedura: aprire un dataset in Progettazione DataSet.
Se non è già disponibile un TableAdapter, crearne uno. Per ulteriori informazioni sulla creazione di TableAdapter, vedere Procedura: creare oggetti TableAdapter.
Se nel TableAdapter è già presente una query che utilizza un'istruzione SQL per la restituzione di righe, passare alla procedura successiva, "Per dichiarare un'istanza del TableAdapter ed eseguire la query". In caso contrario, continuare con il passaggio 4 per creare una nuova query che restituisce righe.
Fare clic con il pulsante destro del mouse sull'oggetto TableAdapter desiderato e aggiungere una query mediante il menu di scelta rapida.

Viene aperta la Configurazione guidata query TableAdapter.
Lasciare il valore predefinito Usa istruzioni SQL e scegliere Avanti.
Lasciare il valore predefinito SELECT che restituisce righe e scegliere Avanti.
Digitare l'istruzione SQL oppure utilizzare Generatore di query per ottenere informazioni sulla creazione di un'istruzione e scegliere Avanti.
Immettere un nome per la query.
Completare la procedura guidata. La query verrà aggiunta al TableAdapter.
Compilazione del progetto.

Per dichiarare un'istanza del TableAdapter ed eseguire la query

Dichiarare un'istanza del TableAdapter che contiene la query da eseguire.
- Per creare un'istanza con gli strumenti di progettazione, trascinare il TableAdapter prescelto dalla Casella degli strumenti. I componenti del progetto sono ora visualizzati nella Casella degli strumenti sotto a un'intestazione che corrisponde al nome del progetto. Se nella Casella degli strumenti non viene visualizzato il TableAdapter, potrebbe essere necessario compilare il progetto.
  
  -oppure-
- Per creare un'istanza nel codice, sostituire il codice riportato di seguito con i nomi della classe DataSet e del TableAdapter.
  
  Dim tableAdapter As New DataSetTableAdapters.TableAdapter
  
  Nota
  
  I TableAdapter non si trovano all'interno delle classi di dataset associate. Per ogni dataset esiste un insieme corrispondente di TableAdapter nel relativo spazio dei nomi. Per un dataset denominato SalesDataSet, ad esempio, esiste uno spazio dei nomi SalesDataSetTableAdapters che contiene i rispettivi TableAdapter.
Chiamare la query procedendo come per qualsiasi altro metodo nel codice. La query è un metodo eseguito sull'oggetto TableAdapter. Sostituire il codice che segue con i nomi del TableAdapter e della query. Sarà necessario inoltre passare i parametri eventualmente richiesti dalla query. In caso di dubbi sulla necessità di parametri per la query o sul tipo di parametri richiesti, verificare che in IntelliSense sia presente la firma richiesta della query. A seconda che la query richieda parametri oppure no, il codice risulterà simile al seguente:

TableAdapter.Query()

TableAdapter.Query(Parameters)

TableAdapter.Query(DataTable, Parameters)

Il codice completo per la dichiarazione di un'istanza del TableAdapter e l'esecuzione della query dovrebbe risultare simile al seguente:

Dim tableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()
tableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")

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

tableAdapter.FillByCity(northwindDataSet.Customers, "Seattle");

Esecuzione di istruzioni SQL che restituiscono righe mediante un oggetto comando

Nell'esempio riportato di seguito viene illustrato come creare un comando ed eseguire un'istruzione SQL che restituisce righe. Per informazioni sull'impostazione e il recupero di valori di parametri per un comando, vedere Procedura: ottenere e impostare parametri per oggetti comando.

Nell'esempio che segue viene utilizzato l'oggetto SqlCommand e devono essere soddisfatti i seguenti requisiti:

Riferimenti agli spazi dei nomi System, System.Data, System.Data.SqlClient e System.Xml.
Una connessione dati denominata sqlConnection1.
Una tabella denominata Customers nell'origine dati cui è connessa sqlConnection1. Altrimenti, è necessaria un'istruzione SQL valida per l'origine dati.

Per eseguire un'istruzione SQL che restituisce righe a livello di codice utilizzando un oggetto comando

Aggiungere il codice riportato di seguito a un metodo da cui si desidera eseguire il codice. Per la restituzione delle righe è possibile chiamare il metodo ExecuteReader del comando, ad esempio ExecuteReader. I dati vengono restituiti in un oggetto SqlDataReader. Per ulteriori informazioni sull'accesso ai dati in un oggetto SqlDataReader, vedere Recupero di dati mediante un DataReader (ADO.NET).

Dim sqlConnection1 As New SqlConnection("Your Connection String")
Dim cmd As New SqlCommand
Dim reader As SqlDataReader

cmd.CommandText = "SELECT * FROM Customers"
cmd.CommandType = CommandType.Text
cmd.Connection = sqlConnection1

sqlConnection1.Open()

reader = cmd.ExecuteReader()
' Data is accessible through the DataReader object here.

sqlConnection1.Close()

SqlConnection sqlConnection1 = new SqlConnection("Your Connection String");
SqlCommand cmd = new SqlCommand();
SqlDataReader reader;

cmd.CommandText = "SELECT * FROM Customers";
cmd.CommandType = CommandType.Text;
cmd.Connection = sqlConnection1;

sqlConnection1.Open();

reader = cmd.ExecuteReader();
// Data is accessible through the DataReader object here.

sqlConnection1.Close();