SqlCeCommand.ExecuteNonQuery-Methode

Hinweis: Dieser Namespace oder Member bzw. diese Klasse wird nur von .NET Framework, Version 1.1, unterstützt.

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

Public Overridable Function ExecuteNonQuery() As Integer Implements _   IDbCommand.ExecuteNonQuery
[C#]
public virtual int ExecuteNonQuery();
[C++]
public: virtual int ExecuteNonQuery();
[JScript]
public function ExecuteNonQuery() : int;

Rückgabewert

Die Anzahl der betroffenen Zeilen.

Implementiert

IDbCommand.ExecuteNonQuery

Ausnahmen

Hinweise

Zum Ausführen von Katalogoperationen können Sie ExecuteNonQuery verwenden. Sie können damit z. B die Struktur einer Datenbank abfragen oder Datenbankobjekte erstellen, z. B. Tabellen. Sie können mit ExecuteNonQuery auch die Daten in einer Datenbank ändern, ohne ein DataSet zu verwenden, indem Sie die Anweisungen UPDATE, INSERT oder DELETE ausführen.

Bei UPDATE-Anweisungen, INSERT-Anweisungen und DELETE-Anweisungen ist der Rückgabewert die Anzahl der vom Befehl betroffenen Zeilen. Bei allen anderen DML-Anweisungen ist der Rückgabewert -1.

Bei DDL-Anweisungen wie CREATE TABLE oder ALTER TABLE ist der Rückgabewert 0.

Hinweis   Dieses Verhalten unterscheidet sich von dem von System.Data.SqlClient.

Beispiel

[Visual Basic, C#] Im folgenden Beispiel wird ein SqlCeCommand erstellt und anschließend mit ExecuteNonQuery ausgeführt. Im Beispiel werden eine Zeichenfolge, die eine SQL-Anweisung (wie UPDATE, INSERT oder DELETE) ist, sowie eine Zeichenfolge, mit der eine Verbindung mit der Datenquelle erstellt werden soll, übergeben.

 
Public Sub CreateMySqlCeCommand(myExecuteQuery As String, myConnection As SqlCeConnection)
    Dim myCommand As New SqlCeCommand(myExecuteQuery, myConnection)
    myCommand.Connection.Open()
    myCommand.ExecuteNonQuery()
    myConnection.Close()
End Sub 

[C#] 
public void CreateMySqlCeCommand(string myExecuteQuery, SqlCeConnection myConnection) {
    SqlCeCommand myCommand = new SqlCeCommand(myExecuteQuery, myConnection);
    myCommand.Connection.Open();
    myCommand.ExecuteNonQuery();
    myConnection.Close();
}

[C++, JScript] Für C++ oder JScript ist kein Beispiel verfügbar. Klicken Sie zum Anzeigen eines Beispiels für Visual Basic oder C# in der linken oberen Ecke der Seite auf die Schaltfläche "Sprachfilter" .

Anforderungen

Plattformen: .NET Compact Framework - Windows CE .NET

.NET Framework-Sicherheit:

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

SqlCeCommand-Klasse | SqlCeCommand-Member | System.Data.SqlServerCe-Namespace