SqlBatch.ExecuteNonQuery 方法

定義

重要

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

針對其連接物件執行批次，傳回所有批次命令所影響的數據列總數。

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

Int32

所有批次命令中受影響的數據列總數。

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

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

針對 UPDATE、INSERT 和 DELETE 語句，傳回值是批次所影響的數據列總數。如果未在批次中包含 UPDATE、INSERT 或 DELETE 語句，則傳回值為 -1。

注意

這個方法的優點是 ExecuteNonQuery()，而且該方法的所有預期例外狀況也適用於這裡。