OdbcCommand.ExecuteNonQuery Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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.