IDbCommand.ExecuteNonQuery Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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
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.