Udostępnij za pośrednictwem


OleDbCommand.ExecuteNonQuery Metoda

Definicja

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 -> int
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Overrides Function ExecuteNonQuery () As Integer
Public Function ExecuteNonQuery () As Integer

Zwraca

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.

Dotyczy

Zobacz też