SqlCeCommand.ExecuteNonQuery Method

Esegue un'istruzione SQL in relazione alla classe SqlCeConnection e restituisce il numero di righe interessate.

Spazio dei nomi: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Sintassi

'Dichiarazione
Public Overrides Function ExecuteNonQuery As Integer

public override int ExecuteNonQuery ()

public:
virtual int ExecuteNonQuery () override

public int ExecuteNonQuery ()

public override function ExecuteNonQuery () : int

Valore restituito

Numero di righe interessate.

Eccezioni

Tipo di eccezione	Condizione
InvalidOperationException	La connessione non esiste. oppure La connessione non è aperta. oppure Impossibile eseguire un comando all'interno di un contesto di transazione differente da quello in cui la connessione è stata in origine inserita.

Osservazioni

È possibile utilizzare il metodo ExecuteNonQuery per eseguire operazioni di catalogo. Ad esempio, è possibile utilizzare tale metodo per effettuare query sulla struttura di un database o per creare oggetti di database quali tabelle. È anche possibile utilizzare il metodo ExecuteNonQuery per modificare i dati in un database senza utilizzare un oggetto DataSet mediante l'esecuzione di istruzioni UPDATE, INSERT o DELETE.

Importante

Il metodo ExecuteNonQuery non utilizza un cursore e pertanto non inserisce blocchi sul database. Se si emette un comando che richiede un blocco, non utilizzare ExecuteNonQuery. Utilizzare invece ExecuteReader.

Nel caso delle istruzioni UPDATE, INSERT e DELETE, il valore restituito è il numero di righe interessate dal comando. Per tutte le altre istruzioni DML, il valore restituito è -1.

Per le istruzioni DDL quali CREATE TABLE o ALTER TABLE, il valore restituito è 0.

Nota

Questo comportamento è diverso da quello di System.Data.SqlClient.

Esempio

Nell'esempio che segue viene creato un oggetto SqlCeCommand, che viene quindi eseguito mediante ExecuteNonQuery. Nell'esempio viene passata una stringa che consiste in un'istruzione SQL, quale UPDATE, INSERT o DELETE, e una stringa per la connessione all'origine dati.

conn.Open()
Dim cmd As New SqlCeCommand("INSERT INTO foo (col1) VALUES (1)", conn)
cmd.ExecuteNonQuery()
conn.Close()

conn.Open();
SqlCeCommand cmd = new SqlCeCommand("INSERT INTO foo (col1) VALUES (1)", conn);
cmd.ExecuteNonQuery();
conn.Close();

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace