Esporta (0) Stampa
Espandi tutto

Metodo SqlCommand.ExecuteNonQuery

Consente di eseguire un'istruzione Transact-SQL in base alla connessione e restituisce un numero di righe modificate.

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

public override int ExecuteNonQuery ()
public int ExecuteNonQuery ()
public override function ExecuteNonQuery () : int

Valore restituito

Numero di righe interessate.

Tipo di eccezioneCondizione

SqlException

È stata generata un'eccezione durante l'esecuzione del comando su una riga bloccata. Tale eccezione non viene generata quando si utilizza Microsoft .NET Framework Versione 1.0.

È possibile utilizzare il metodo ExecuteNonQuery per eseguire operazioni di catalogo (ad esempio, eseguire query sulla struttura di un database o creare oggetti del database quali tabelle) oppure modificare i dati contenuti in un database senza utilizzare un oggetto DataSet eseguendo le istruzioni UPDATE, INSERT o DELETE.

Sebbene il metodo ExecuteNonQuery non restituisca alcuna riga, eventuali parametri di output o valori restituiti mappati a parametri vengono compilati mediante dati.

Nel caso delle istruzioni UPDATE, INSERT e DELETE, il valore restituito è il numero di righe interessate dal comando. Per tutti gli altri tipi di istruzioni, il valore restituito è -1. Anche se si verifica un'operazione di rollback, il valore restituito sarà -1.

Nell'esempio che segue viene creato un oggetto SqlCommand, che viene quindi eseguito mediante il metodo ExecuteNonQuery. All'esempio viene passata una stringa che è un'istruzione Transact-SQL (UPDATE, INSERT o DELETE) e una stringa da utilizzare per la connessione all'origine dati.

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0 1.1 1.0

.NET Compact Framework

Supportato in: 2.0 1.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2015 Microsoft