IDbCommand.ExecuteNonQuery Methode

Definitie

Voert een SQL-instructie uit op het Connection-object van een .NET gegevensprovider en retourneert het aantal betrokken rijen.

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

Retouren

Het aantal rijen dat is beïnvloed.

Uitzonderingen

De verbinding bestaat niet.

– of –

De verbinding is niet geopend.

Voorbeelden

In het volgende voorbeeld wordt een exemplaar van de afgeleide klasse OleDbCommandgemaakt en vervolgens uitgevoerd. Hiervoor wordt de methode doorgegeven aan een tekenreeks die een SQL SELECT-instructie is en een tekenreeks die moet worden gebruikt om verbinding te maken met de gegevensbron.

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

Opmerkingen

U kunt catalogusbewerkingen ExecuteNonQuery uitvoeren (bijvoorbeeld het uitvoeren van query's op de structuur van een database of het maken van databaseobjecten zoals tabellen) of het wijzigen van de gegevens in een database zonder een DataSet update-, INSERT- of DELETE-instructies uit te voeren.

Hoewel er ExecuteNonQuery geen rijen worden geretourneerd, worden uitvoerparameters of retourwaarden die aan parameters zijn toegewezen, gevuld met gegevens.

Voor de instructies UPDATE, INSERT en DELETE is de retourwaarde het aantal rijen dat wordt beïnvloed door de opdracht. Voor alle andere typen instructies is de retourwaarde -1.

Van toepassing op