OleDbCommand.ExecuteNonQuery Metoda

Definicja

Przestrzeń nazw:

System.Data.OleDb

Zestaw:

System.Data.OleDb.dll

Pakiet:

System.Data.OleDb v8.0.0

Źródło:

OleDbCommand.cs

Wykonuje instrukcję SQL względem elementu Connection i zwraca liczbę wierszy, których dotyczy problem.

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

Zwraca

Int32

Liczba wierszy, których dotyczy problem.

Implementuje

ExecuteNonQuery()

Wyjątki

InvalidOperationException

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.

Zobacz też

• Praca z poleceniami