SqlCommand.ExecuteNonQuery 方法

SqlCommand.ExecuteNonQuery 方法

對串連執行 Transact-SQL 陳述式並返回受影響的行數，為int資料類型

命名空間:System.Data.SqlClient
程式集:System.Data（在 system.data.dll
中）

 文法

C#

public override int ExecuteNonQuery ()

C++

public:virtual int ExecuteNonQuery () override

J#

public int ExecuteNonQuery ()

JScript

public override function ExecuteNonQuery () : int

傳回值

受影響的行數。

 異常

異常類型	條件
SqlException	在對鎖定的行執行該命令期間發生了異常。如果使用的是 Microsoft .NET Framework 1.0 版，將不會產生該異常。

 備忘

您可以使用 ExecuteNonQuery 來執行目錄操作（例如查詢資料庫的結構或建立諸如表等的資料庫物件），或通過執行
UPDATE、INSERT 或 DELETE 語句，在不使用 DataSet
的情況下更改資料庫中的資料。

雖然 ExecuteNonQuery 不返回任何行，但映射到參數的任何輸出參數或傳回值都會用資料進行填充。

對於 UPDATE、INSERT 和 DELETE 語句，傳回值為該命令所影響的行數。對於所有其他類型的語句，傳回值為 -1。如果發生復原，傳回值也為
-1。

 樣本

下面的樣本建立一個 SqlCommand，然後使用
ExecuteNonQuery 執行它。給該樣本傳遞兩個字串：一個字串是 Transact-SQL 陳述式（如 UPDATE、INSERT 或
DELETE），另一個字串用於串連資料來源。

C#
複製代碼

private static void CreateCommand(string queryString,string connectionString){using (SqlConnection connection = new SqlConnection(connectionString)){SqlCommand command = new
 
 
SqlCommand(queryString, connection);command.Connection.Open();command.ExecuteNonQuery();}
 
}
封裝寫法：