IDbCommand.ExecuteNonQuery Metod

Definition

Kör en SQL-instruktion mot Connection-objektet för en .NET dataprovider och returnerar antalet rader som påverkas.

public:
 int ExecuteNonQuery();
public int ExecuteNonQuery();
abstract member ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer

Returer

Antalet rader som påverkas.

Undantag

Anslutningen finns inte.

-eller-

Anslutningen är inte öppen.

Exempel

I följande exempel skapas en instans av den härledda klassen, OleDbCommand, och sedan körs den. För att åstadkomma detta skickas metoden en sträng som är en SQL SELECT-instruktion och en sträng som ska användas för att ansluta till datakällan.

static private void CreateOleDbCommand(
    string queryString, string connectionString)
{
    using (OleDbConnection connection = new
               OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbCommand command = new
            OleDbCommand(queryString, connection);
        command.ExecuteNonQuery();
    }
}
Private Sub CreateOleDbCommand( _
    ByVal queryString As String, ByVal connectionString As String)
    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim command As New OleDbCommand(queryString, connection)
        command.ExecuteNonQuery()
    End Using
End Sub

Kommentarer

Du kan använda ExecuteNonQuery för att utföra katalogåtgärder (till exempel köra frågor mot strukturen för en databas eller skapa databasobjekt som tabeller) eller ändra data i en databas utan att använda en DataSet genom att köra UPDATE-, INSERT- eller DELETE-instruktioner.

ExecuteNonQuery Även om inte returnerar några rader fylls alla utdataparametrar eller returvärden som mappas till parametrar med data.

För UPDATE-, INSERT- och DELETE-instruktioner är returvärdet antalet rader som påverkas av kommandot. För alla andra typer av instruktioner är returvärdet -1.

Gäller för