IDbCommand.ExecuteNonQuery Metódus

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Forrás:

IDbCommand.cs

Sql-utasítást hajt végre egy .NET adatszolgáltató Connection objektumán, és visszaadja az érintett sorok számát.

public:
 int ExecuteNonQuery();

public int ExecuteNonQuery();

abstract member ExecuteNonQuery : unit -> int

Public Function ExecuteNonQuery () As Integer

Válaszok

Int32

Az érintett sorok száma.

Kivételek

InvalidOperationException

A kapcsolat nem létezik.

-vagy-

A kapcsolat nincs megnyitva.

Példák

Az alábbi példa létrehozza a származtatott osztály egy példányát, OleDbCommandmajd végrehajtja azt. Ennek érdekében a metódus egy SQL SELECT utasítást tartalmazó sztringet és egy, az adatforráshoz való csatlakozáshoz használandó sztringet ad át.

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

Megjegyzések

A használatával ExecuteNonQuery katalógusműveleteket hajthat végre (például lekérdezheti az adatbázis struktúráját, vagy adatbázis-objektumokat, például táblákat hozhat létre), vagy módosíthatja az adatbázisban lévő adatokat az UPDATE, INSERT vagy DELETE utasítások végrehajtása nélkül DataSet .

Bár a ExecuteNonQuery rendszer nem ad vissza sorokat, a paraméterekre leképezett kimeneti paraméterek vagy visszatérési értékek adatokkal vannak feltöltve.

AZ UPDATE, INSERT és DELETE utasítás esetén a visszatérési érték a parancs által érintett sorok száma. Minden más típusú utasítás esetén a visszatérési érték -1.