OleDbCommand.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.
Hiermee wordt een SQL-instructie uitgevoerd op basis van de Connection instructie en wordt het aantal betrokken rijen geretourneerd.
public:
virtual int ExecuteNonQuery();public:
override int ExecuteNonQuery();public int ExecuteNonQuery();public override int ExecuteNonQuery();abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> intoverride this.ExecuteNonQuery : unit -> intPublic Function ExecuteNonQuery () As IntegerPublic Overrides Function ExecuteNonQuery () As IntegerRetouren
Het aantal rijen dat is beïnvloed.
Implementeringen
Uitzonderingen
De verbinding bestaat niet.
– of –
De verbinding is niet geopend.
– of –
Kan een opdracht niet uitvoeren binnen een transactiecontext die verschilt van de context waarin de verbinding oorspronkelijk is opgenomen.
Voorbeelden
In het volgende voorbeeld wordt een OleDbCommand gemaakt en vervolgens uitgevoerd met behulp van ExecuteNonQuery. Het voorbeeld wordt doorgegeven aan een tekenreeks die een SQL-instructie is, zoals UPDATE, INSERT of DELETE, 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 de ExecuteNonQuery opdracht gebruiken om catalogusbewerkingen uit te voeren, bijvoorbeeld om een query uit te voeren op de structuur van een database of om databaseobjecten zoals tabellen te maken of om de gegevens in een database te wijzigen zonder DataSet een update-, INSERT- of DELETE-instructies uit te voeren.
Hoewel het ExecuteNonQuery resultaat geen rijen retourneert, worden alle uitvoerparameters of retourwaarden die zijn toegewezen aan parameters 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. Als er een terugdraaiactie plaatsvindt, is de retourwaarde ook -1.