共用方式為


OleDbCommand.ExecuteNonQuery 方法

定義

針對 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

傳回

受影響的資料列數目。

實作

例外狀況

連接不存在。

-或-

連接未開啟。

-或-

如果某項交易內容與原本連接登記的內容不同,便無法在那個交易內容中執行命令。

範例

下列範例會建立 , OleDbCommand 然後使用 執行它 ExecuteNonQuery。 此範例會傳遞字串,該字串是 SQL 語句,例如 UPDATE、INSERT 或 DELETE,以及用來連接到數據源的字串。

static private void CreateOleDbCommand(
    string queryString, string connectionString)
{
    using (OleDbConnection connection = new
               OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbCommand command = new
            OleDbCommand(queryString, connection);
        command.ExecuteNonQuery();
    }
}
Private Sub CreateOleDbCommand( _
    ByVal queryString As String, ByVal connectionString As String)
    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim command As New OleDbCommand(queryString, connection)
        command.ExecuteNonQuery()
    End Using
End Sub

備註

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

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

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

適用於

另請參閱