OleDbCommand.ExecuteNonQuery Metoda

Definice

Spustí příkaz SQL proti Connection a vrátí počet ovlivněných řádků.

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

Návraty

Počet ovlivněných řádků

Implementuje

Výjimky

Připojení neexistuje.

-nebo-

Připojení není otevřené.

-nebo-

Nelze spustit příkaz v kontextu transakce, který se liší od kontextu, ve kterém bylo připojení původně zapsáno.

Příklady

Následující příklad vytvoří objekt a pak ho OleDbCommand spustí pomocí ExecuteNonQuerypříkazu . Příklad je předán řetězec, který je příkazem SQL, například UPDATE, INSERT nebo DELETE, a řetězec, který se má použít pro připojení ke zdroji dat.

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

Poznámky

Nástroj můžete použít ExecuteNonQuery k provádění operací katalogu, například k dotazování struktury databáze nebo k vytváření databázových objektů, jako jsou tabulky, nebo ke změně dat v databázi bez použití DataSet příkazů UPDATE, INSERT nebo DELETE.

Přestože nevrací ExecuteNonQuery žádné řádky, všechny výstupní parametry nebo návratové hodnoty namapované na parametry se naplní daty.

U příkazů UPDATE, INSERT a DELETE je návratovou hodnotou počet řádků ovlivněných příkazem. Pro všechny ostatní typy příkazů je návratová hodnota -1. Pokud dojde k vrácení zpět, je návratová hodnota také -1.

Platí pro

Viz také