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

Articolo
09/12/2008

Aggiornamento: novembre 2007

Per eseguire un'istruzione SQL che restituisca un singolo valore, è possibile utilizzare una query TableAdapter configurata in modo da eseguire un'istruzione SQL, come ad esempio CustomersTableAdapter.CustomerCount().

Se nell'applicazione non vengono utilizzati TableAdapter, chiamare il metodo ExecuteScalar su un oggetto comando, impostando la relativa 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 che seguono viene illustrato come eseguire istruzioni SQL che restituiscono singoli valori da un database utilizzando TableAdapter oppure oggetti comando. Per ulteriori informazioni sull'esecuzione di query con TableAdapter e comandi, vedere Cenni preliminari sul riempimento dei dataset e l'esecuzione di query sui dati.

Nota:
Le finestre di dialogo e i comandi di menu visualizzati potrebbero variare rispetto a quanto descritto nella Guida in linea in base alle impostazioni o all'edizione in uso. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Impostazioni di Visual Studio.

Esecuzione di istruzioni SQL che restituiscono singoli valori utilizzando un TableAdapter

Nell'esempio che segue viene illustrato come creare una query TableAdapter utilizzando la Configurazione guidata query TableAdapter, quindi vengono fornite informazioni su come dichiarare un'istanza di TableAdapter ed eseguire la query.

Per creare un'istruzione SQL che restituisce un valore utilizzando 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 esiste già una query su un determinato TableAdapter che utilizza un'istruzione SQL per la restituzione di un singolo valore, passare direttamente alla procedura successiva "Per dichiarare un'istanza del TableAdapter ed eseguire la query". In caso contrario, procedere con il passaggio 4 per creare una nuova query che restituisca un valore.
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, quindi scegliere Avanti.
Selezionare l'opzione SELECT che restituisce un valore, quindi scegliere Avanti.
Digitare l'istruzione SQL o utilizzare il Generatore di query per crearne una, quindi scegliere Avanti.
Immettere un nome per la query.
Completare la procedura guidata. La query verrà aggiunta al TableAdapter.
Generazione 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 generare 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. È anche necessario passare i parametri richiesti dalla query e utilizzare in qualche modo il valore restituito, ad esempio assegnandolo a una variabile. 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 accetti o meno parametri, il codice risulterà simile a uno degli esempi riportati di seguito.

TableAdapter.Query()

TableAdapter.Query(Parameters)
Potrebbe essere necessario assegnare il valore restituito dalla query a una variabile. Diversamente dal metodo ExecuteScalar che restituisce un oggetto, il tipo di dati restituito dalle query TableAdapter che producono un singolo valore dipenderà dalla query. Se, ad esempio, la query TableAdapter determina la selezione di una singola colonna con tipo di dati integer, il valore da essa restituito sarà di questo tipo. Se nella colonna sono consentiti valori Null, il valore restituito corrisponderà a uno dei tipi nullable, quale Nullable(Of Integer). Per ulteriori informazioni sui tipi nullable, vedere Nullable. Il codice completo necessario per la dichiarazione di un'istanza di un TableAdapter e l'esecuzione di una query sarà simile a quello riportato di seguito. L'esempio che segue parte dal presupposto che il valore restituito sia un valore integer. Pertanto, modificare il codice in base al tipo di dati restituito dalla query.
```
Dim tableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()

Dim returnValue As Integer
returnValue = CType(tableAdapter.GetCustomerCount(), Integer)
```
```
NorthwindDataSetTableAdapters.CustomersTableAdapter tableAdapter = 
    new NorthwindDataSetTableAdapters.CustomersTableAdapter();

int returnValue = (int)tableAdapter.GetCustomerCount();
```

Esecuzione di istruzioni SQL che restituiscono singoli valori utilizzando un oggetto comando

Nell'esempio che segue viene illustrato come creare un comando ed eseguire un'istruzione SQL che restituisce un valore. Per informazioni sull'impostazione e il recupero dei valori dei 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 e System.Xml.
Una connessione dati denominata SqlConnection1.
Una tabella denominata Customers nell'origine dati cui è collegato SqlConnection1. Altrimenti, specificare un'istruzione SQL valida per l'origine dati.

Per eseguire un'istruzione SQL che restituisce un valore utilizzando un DataCommand

Aggiungere il codice che segue al metodo da cui eseguirlo. Per restituire un singolo valore, chiamare il metodo ExecuteScalar di un comando, ad esempio ExecuteScalar. I dati vengono restituiti in un Object.

Dim sqlConnection1 As New SqlConnection("Your Connection String")
Dim cmd As New SqlCommand
Dim returnValue As Object

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

sqlConnection1.Open()

returnValue = cmd.ExecuteScalar()

sqlConnection1.Close()

SqlConnection sqlConnection1 = new SqlConnection("Your Connection String");
SqlCommand cmd = new SqlCommand();
Object returnValue;

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

sqlConnection1.Open();

returnValue = cmd.ExecuteScalar();

sqlConnection1.Close();

Sicurezza

Per l'accesso al database e l'esecuzione dell'istruzione SQL è richiesta un'autorizzazione.

Vedere anche

Share via

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

Esecuzione di istruzioni SQL che restituiscono singoli valori utilizzando un TableAdapter

Per creare un'istruzione SQL che restituisce un valore utilizzando un TableAdapter

Per dichiarare un'istanza del TableAdapter ed eseguire la query

Esecuzione di istruzioni SQL che restituiscono singoli valori utilizzando un oggetto comando

Per eseguire un'istruzione SQL che restituisce un valore utilizzando un DataCommand

Sicurezza

Vedere anche

Attività

Concetti

Riferimenti

Risorse aggiuntive