Sdílet prostřednictvím


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

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.

Implementuje

Výjimky

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.

Platí pro

Viz také