OleDbCommand.ExecuteNonQuery Metoda

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v8.0.0

Zdroj:

OleDbCommand.cs

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

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

Návraty

Int32

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

Implementuje

ExecuteNonQuery()

Výjimky

InvalidOperationException

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.

Viz také

• Práce s příkazy