OracleCommand.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:
virtual int ExecuteNonQuery();
public:
override int ExecuteNonQuery();
public int ExecuteNonQuery ();
public override int ExecuteNonQuery ();
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer
Public Overrides Function ExecuteNonQuery () As Integer
Zwraca
W przypadku instrukcji UPDATE, INSERT i DELETE zwracana wartość to liczba wierszy, których dotyczy polecenie. W przypadku instrukcji CREATE TABLE i DROP TABLE zwracana wartość to 0. W przypadku wszystkich innych typów instrukcji zwracana wartość to -1.
Implementuje
Wyjątki
Przykłady
Poniższy przykład tworzy obiekt OracleCommand , 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) i ciągiem używanym do nawiązywania połączenia z bazą danych.
public void CreateOracleCommand(string myExecuteQuery, string connectionString)
{
using (OracleConnection connection = new OracleConnection(connectionString))
{
OracleCommand command = new OracleCommand(myExecuteQuery, connection);
command.Connection.Open();
command.ExecuteNonQuery();
}
}
Public Sub CreateOracleCommand(ByVal myExecuteQuery As String, _
ByVal connectionString As String)
Using connection As New OracleConnection(connectionString)
Dim command As New OracleCommand(myExecuteQuery, connection)
command.Connection.Open()
command.ExecuteNonQuery()
End Using
End Sub
Uwagi
Służy ExecuteNonQuery do wykonywania operacji w katalogu (na przykład wykonywania zapytań dotyczących struktury bazy danych lub tworzenia obiektów bazy danych, takich jak tabele), lub zmiany danych w bazie danych, bez użycia DataSetelementu , przez wykonanie instrukcji UPDATE, INSERT lub DELETE.
Mimo że ExecuteNonQuery nie zwraca żadnych wierszy, żadne parametry wyjściowe ani wartości zwracane zmapowane do parametrów są wypełniane danymi.
W przypadku instrukcji UPDATE, INSERT i DELETE zwracana wartość to liczba wierszy, których dotyczy polecenie. W przypadku instrukcji CREATE TABLE i DROP TABLE zwracana wartość to 0. W przypadku wszystkich innych typów instrukcji zwracana wartość to -1. Jeśli nastąpi wycofanie, zwracana wartość to również -1.