OdbcCommand.ExecuteNonQuery Metoda

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

System.Data.Odbc v8.0.0

Zdroj:

OdbcCommand.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

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.

Výjimky

InvalidOperationException

Připojení neexistuje.

-nebo-

Připojení není otevřené.

Poznámky

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

Můžete také použít ExecuteNonQuery ke spuštění více příkazů SQL, pokud podkladový ovladač ODBC tuto funkci podporuje. V tomto případě je návratová hodnota počet řádků ovlivněných všemi příkazy v příkazu.

Přestože ExecuteNonQuery nevrací žádné řádky, všechny výstupní parametry nebo návratové hodnoty mapované 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.

Pokud v tabulce existuje aktivační událost a data se v tabulce přidávají nebo mění, vrácené hodnoty zahrnují počet řádků ovlivněných operací vložení nebo aktualizace a počet řádků ovlivněných triggerem nebo triggery.

Viz také

• Spuštění příkazu