IDbCommand.ExecuteNonQuery Metoda

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Wykonuje instrukcję SQL względem Connection obiektu dostawcy danych .NET i zwraca liczbę wierszy, których dotyczy problem.

public:
 int ExecuteNonQuery();

public int ExecuteNonQuery ();

abstract member ExecuteNonQuery : unit -> int

Public Function ExecuteNonQuery () As Integer

Zwraca

Int32

Liczba wierszy, których dotyczy problem.

Wyjątki

InvalidOperationException

Połączenie nie istnieje.

-lub-

Połączenie nie jest otwarte.

Przykłady

Poniższy przykład tworzy wystąpienie klasy pochodnej , OleDbCommanda następnie wykonuje je. Aby to osiągnąć, metoda jest przekazywana ciąg, który jest instrukcją SQL SELECT i ciągiem używanym 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

Za pomocą polecenia ExecuteNonQuery można wykonywać operacje wykazu (na przykład wykonywanie zapytań dotyczących struktury bazy danych lub tworzenie obiektów bazy danych, takich jak tabele), lub zmianę danych w bazie danych bez użycia za pomocą DataSet instrukcji UPDATE, INSERT lub DELETE.

Chociaż nie ExecuteNonQuery zwraca żadnych wierszy, żadne parametry wyjściowe lub zwracane wartości mapowane na parametry są wypełniane danymi.

W przypadku instrukcji UPDATE, INSERT i DELETE zwracana wartość to liczba wierszy, których dotyczy polecenie. Dla wszystkich innych typów instrukcji zwracana wartość to -1.