SqlCeCommand.ExecuteNonQuery Method

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

命名空間: System.Data.SqlServerCe
組件: System.Data.SqlServerCe (在 system.data.sqlserverce.dll)

語法

'宣告
Public Overrides Function ExecuteNonQuery As Integer

public override int ExecuteNonQuery ()

public:
virtual int ExecuteNonQuery () override

public int ExecuteNonQuery ()

public override function ExecuteNonQuery () : int

傳回值

受影響的資料列數目。

例外狀況

例外狀況型別	條件
InvalidOperationException	連接不存在。 -或- 連接尚未開啟。 -或- 如果某項交易內容與原本連接登記的內容不同，便無法在那個交易內容中執行命令。

備註

您可以使用 ExecuteNonQuery 來執行目錄作業。例如，可以用它來查詢資料庫結構或建立資料表之類的資料庫物件。也可以藉由執行 UPDATE、INSERT 或 DELETE 陳述式，在不使用 DataSet 的情況下使用 ExecuteNonQuery 來變更資料庫中的資料。

重要

ExecuteNonQuery 不使用資料指標，因此不會鎖定資料庫。如果您正在發出需要鎖定的命令，請勿使用 ExecuteNonQuery，而改用 ExecuteReader。

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

對 DDL 陳述式 (例如 CREATE TABLE 或 ALTER TABLE)，傳回值為 0。

注意

這與 System.Data.SqlClient 的行為不同。

範例

下列範例會建立 SqlCeCommand，然後使用 ExecuteNonQuery 加以執行。範例中會傳遞即為 SQL 陳述式 (例如 UPDATE、INSERT 或 DELETE) 的字串和用於連接至資料來源的字串。

conn.Open()
Dim cmd As New SqlCeCommand("INSERT INTO foo (col1) VALUES (1)", conn)
cmd.ExecuteNonQuery()
conn.Close()

conn.Open();
SqlCeCommand cmd = new SqlCeCommand("INSERT INTO foo (col1) VALUES (1)", conn);
cmd.ExecuteNonQuery();
conn.Close();

執行緒安全性

任何公用靜態 (共用 在 Microsoft Visual Basic) 此型別的成員具備執行緒安全。不保證任何執行個體成員安全執行緒。

平台

開發平台

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
版本資訊
.NET Framework 及 NET Compact Framework
支援於 3.5
.NET Framework
支援於 3.0
.NET Compact Framework 及 .Net Framework
支援於 2.0

另請參閱

參考

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace