OleDbCommand.ExecuteNonQuery Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wykonuje instrukcję SQL względem elementu Connection i zwraca liczbę wierszy, których dotyczy problem.
public:
override int ExecuteNonQuery();public:
virtual int ExecuteNonQuery();public override int ExecuteNonQuery ();public int ExecuteNonQuery ();override this.ExecuteNonQuery : unit -> intabstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> intPublic Overrides Function ExecuteNonQuery () As IntegerPublic Function ExecuteNonQuery () As IntegerZwraca
Liczba wierszy, których dotyczy problem.
Implementuje
Wyjątki
Połączenie nie istnieje.
-lub-
Połączenie nie jest otwarte.
-lub-
Nie można wykonać polecenia w kontekście transakcji, który różni się od kontekstu, w którym połączenie zostało pierwotnie wymienione.
Przykłady
Poniższy przykład tworzy obiekt OleDbCommand , a następnie wykonuje go przy użyciu polecenia ExecuteNonQuery. Przykład jest przekazywany ciąg, który jest instrukcją SQL, taką jak UPDATE, INSERT lub DELETE, oraz ciąg używany do nawiązywania połączenia ze źródłem danych.
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
Uwagi
Możesz użyć polecenia ExecuteNonQuery , aby wykonać operacje katalogu, na przykład, aby wykonać zapytanie dotyczące struktury bazy danych lub utworzyć obiekty bazy danych, takie jak tabele, lub zmienić dane w bazie danych bez użycia , DataSet wykonując instrukcje UPDATE, INSERT lub DELETE.
ExecuteNonQuery Mimo że funkcja nie zwraca żadnych wierszy, parametry wyjściowe lub zwracane wartości zamapowane na parametry są wypełniane danymi.
W przypadku instrukcji UPDATE, INSERT i DELETE zwracana wartość to liczba wierszy, których dotyczy polecenie. W przypadku wszystkich innych typów instrukcji zwracana wartość to -1. Jeśli nastąpi wycofanie, zwracana wartość to również -1.
