Procedura: creare ed eseguire un'istruzione SQL che non restituisce valori

Articolo
09/12/2008

Aggiornamento: novembre 2007

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

Se nell'applicazione non vengono utilizzati TableAdapter, chiamare il metodo ExecuteNonQuery 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 nell'applicazione. Nel caso in cui, ad esempio, l'applicazione utilizzi il Provider di dati .NET Framework per SQL Server, l'oggetto comando sarebbe SqlCommand.

Negli esempi che seguono viene illustrato come eseguire istruzioni SQL che non restituiscono 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.

Esecuzione di istruzioni SQL che non restituiscono valori mediante un TableAdapter

In questo esempio viene illustrato come creare una query TableAdapter mediante la Configurazione guidata query TableAdapter 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 in linea 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 Impostazioni di Visual Studio.

Per creare un'istruzione SQL che non restituisce valori utilizzando un TableAdapter

Aprire un dataset in Progettazione DataSet. Per ulteriori informazioni, vedere Procedura: aprire un dataset in Progettazione DataSet.
Creare un TableAdapter, se non ne è già disponibile 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 che non restituisce valori, passare direttamente 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 non restituisce valori.
Fare clic con il pulsante destro del mouse sull'oggetto TableAdapter desiderato e aggiungere una query mediante il menu di scelta rapida.

Verrà aperta la Configurazione guidata query TableAdapter.
Lasciare il valore predefinito Usa istruzioni SQL, quindi scegliere Avanti.
Scegliere l'opzione UPDATE, INSERT o DELETE e fare clic su Avanti.
Digitare l'istruzione SQL oppure utilizzare Generatore di query per ottenere informazioni sulla creazione di un'istruzione e scegliere Avanti.
Fornire 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 che si desidera 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:
In realtà 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. A un dataset denominato SalesDataSet, ad esempio, è associato uno spazio dei nomi SalesDataSetTableAdapters che contiene i relativi TableAdapter.

Chiamare la query procedendo come per qualsiasi altro metodo nel codice. La query è un metodo del TableAdapter. Sostituire il codice riportato di seguito 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 accetti o meno parametri, il codice risulterà simile a uno dei seguenti esempi:

TableAdapter.Query()

TableAdapter.Query(Parameters)

Le query che apparentemente non restituiscono valori in realtà restituiscono un valore integer contenente il numero di righe modificate dalla query. Il codice completo per la dichiarazione di un'istanza di un TableAdapter e l'esecuzione di una query dovrebbe risultare simile al seguente:
```
Dim tableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()

Dim rowsAffected As Integer
rowsAffected = CType(tableAdapter.UpdateContactTitle("Sales Manager", "ALFKI"), Integer)
```
```
NorthwindDataSetTableAdapters.CustomersTableAdapter tableAdapter = 
    new NorthwindDataSetTableAdapters.CustomersTableAdapter();

int rowsAffected = tableAdapter.UpdateContactTitle("Sales Manager", "ALFKI");
```

Esecuzione di istruzioni SQL che non restituiscono valori mediante un oggetto comando

Nell'esempio riportato di seguito viene illustrato come creare un comando ed eseguire un'istruzione SQL che non restituisce valori. 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 e System.Xml.
Una connessione dati denominata SqlConnection1.
Una tabella denominata Customers nell'origine dati cui è collegato SqlConnection1. Altrimenti, è necessaria un'istruzione SQL valida per l'origine dati.

Per eseguire un'istruzione SQL che non restituisce valori utilizzando un DataCommand

Aggiungere il codice che segue a un metodo dal quale si desidera eseguire l'istruzione SQL. Chiamare il metodo ExecuteNonQuery di un comando per non restituire valori, ad esempio SqlCommand.ExecuteNonQuery.

Dim sqlConnection1 As New SqlConnection("Your Connection String")
Dim cmd As New SqlCommand
Dim rowsAffected As Integer

cmd.CommandText = "UPDATE Customers SET ContactTitle = 'Sales Manager' WHERE CustomerID = 'ALFKI'"
cmd.CommandType = CommandType.Text
cmd.Connection = sqlConnection1

sqlConnection1.Open()

rowsAffected = cmd.ExecuteNonQuery()

sqlConnection1.Close()

SqlConnection sqlConnection1 = new SqlConnection("Your Connection String");
SqlCommand cmd = new SqlCommand();
Int32 rowsAffected;

cmd.CommandText = "UPDATE Customers SET ContactTitle = 'Sales Manager' WHERE CustomerID = 'ALFKI'";
cmd.CommandType = CommandType.Text;
cmd.Connection = sqlConnection1;

sqlConnection1.Open();

rowsAffected = cmd.ExecuteNonQuery();

sqlConnection1.Close();

Sicurezza

Per accedere al database ed eseguire l'istruzione SQL è richiesta l'autorizzazione.

Vedere anche

Share via

Procedura: creare ed eseguire un'istruzione SQL che non restituisce valori

Esecuzione di istruzioni SQL che non restituiscono valori mediante un TableAdapter

Per creare un'istruzione SQL che non restituisce valori utilizzando un TableAdapter

Per dichiarare un'istanza del TableAdapter ed eseguire la query

Esecuzione di istruzioni SQL che non restituiscono valori mediante un oggetto comando

Per eseguire un'istruzione SQL che non restituisce valori utilizzando un DataCommand

Sicurezza

Vedere anche

Attività

Concetti

Riferimenti

Risorse aggiuntive