OleDbCommand.ExecuteNonQuery Metod

Definition

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

public:
 virtual int ExecuteNonQuery();
public:
 override int ExecuteNonQuery();
public int ExecuteNonQuery();
public override int ExecuteNonQuery();
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer
Public Overrides Function ExecuteNonQuery () As Integer

Returer

Antalet rader som påverkas.

Implementeringar

Undantag

Anslutningen finns inte.

-eller-

Anslutningen är inte öppen.

-eller-

Det går inte att köra ett kommando i en transaktionskontext som skiljer sig från den kontext där anslutningen ursprungligen registrerades.

Exempel

I följande exempel skapas en OleDbCommand och körs sedan med hjälp av ExecuteNonQuery. Exemplet skickas en sträng som är en SQL-instruktion som UPDATE, INSERT eller DELETE 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 för att fråga efter strukturen för en databas eller för att skapa databasobjekt som tabeller, eller för att ändra data i en databas utan att använda en DataSet genom att köra UPDATE-, INSERT- eller DELETE-instruktioner.

ExecuteNonQuery Även om returnerar inga 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. Om en återställning inträffar är returvärdet också -1.

Gäller för

Se även