SqlCommand.ExecuteNonQuery-Methode

Führt eine Transact-SQL-Anweisung für die Verbindung aus und gibt die Anzahl der betroffenen Zeilen zurück.

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overrides Function ExecuteNonQuery As Integer
'Usage
Dim instance As SqlCommand
Dim returnValue As Integer

returnValue = instance.ExecuteNonQuery

public override int ExecuteNonQuery ()

public:
virtual int ExecuteNonQuery () override

public int ExecuteNonQuery ()

public override function ExecuteNonQuery () : int

Rückgabewert

Die Anzahl der betroffenen Zeilen.

Ausnahmen

Hinweise

Mit ExecuteNonQuery können Sie Katalogoperationen ausführen (z. B. Abfragen der Struktur einer Datenbank oder Erstellen von Datenbankobjekten wie Tabellen) oder die Daten in einer Datenbank ändern, ohne ein DataSet zu verwenden, indem Sie UPDATE-Anweisungen, INSERT-Anweisungen oder DELETE-Anweisungen ausführen.

ExecuteNonQuery gibt keine Zeilen zurück. Es werden aber Parametern zugeordnete Ausgabeparameter oder Rückgabewerte mit Daten aufgefüllt.

Bei UPDATE-Anweisungen, INSERT-Anweisungen und DELETE-Anweisungen ist der Rückgabewert die Anzahl der vom Befehl betroffenen Zeilen. Für alle anderen Anweisungstypen ist der Rückgabewert ­1. Bei einem Rollback ist der Rückgabewert ebenfalls ­1.

Beispiel

Im folgenden Beispiel wird ein SqlCommand erstellt und dieser anschließend mit ExecuteNonQuery ausgeführt. Im Beispiel wird eine Transact-SQL-Anweisung (wie UPDATE, INSERT oder DELETE) als Zeichenfolge sowie eine Zeichenfolge übergeben, mit der die Verbindung mit der Datenquelle hergestellt wird.

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

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();
    }
}

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlCommand-Klasse
SqlCommand-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server