OdbcCommand.ExecuteNonQuery 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

針對 Connection 執行 SQL 陳述式，並傳回受影響的資料列數。

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

Int32

對 UPDATE、INSERT 和 DELETE 陳述式而言，傳回值是受命令影響的資料列數目。對其他類型的陳述式而言，傳回值為 -1。

ExecuteNonQuery()

連接不存在。

-或-

連接未開啟。

例如，您可以使用 ExecuteNonQuery 來執行目錄作業 (，查詢資料庫的結構，或建立資料庫物件，例如數據表) ;或藉由執行 UPDATE、INSERT 或 DELETE 語句來變更資料庫中 DataSet的數據。

如果基礎 ODBC 驅動程式支援此功能，您也可以使用 ExecuteNonQuery 來執行多個 SQL 語句。在此情況下，傳回值是命令中所有語句所影響的數據列數目。

雖然 ExecuteNonQuery 不會傳回任何數據列，但對應至參數的任何輸出參數或傳回值會填入數據。

對 UPDATE、INSERT 和 DELETE 陳述式而言，傳回值是受命令影響的資料列數目。對其他類型的陳述式而言，傳回值為 -1。如果發生復原，傳回值也是 -1。

當數據表上有觸發程式，且數據表中的數據正在加入或變更時，傳回值會包含受插入或更新作業影響的數據列數目，以及觸發程式或觸發程式所影響的數據列數目。