OracleCommand.ExecuteNonQuery Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.OracleClient
Zestaw:
System.Data.OracleClient.dll

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

Int32

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

ExecuteNonQuery()

Wyjątki

InvalidOperationException

Połączenie nie istnieje.

-lub-

Połączenie nie jest otwarte.

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.

Dotyczy

Zobacz też