IDbCommand.ExecuteNonQuery 方法

定義

命名空間:
System.Data
組件:
System.Data.dll
組件:
netstandard.dll

對.NET資料提供者的 Connection 物件執行 SQL 陳述句，並回傳受影響的列數。

public:
 int ExecuteNonQuery();
public int ExecuteNonQuery();
abstract member ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer

傳回

Int32

受影響的行數。

例外狀況

InvalidOperationException

這種連結並不存在。

-或-

連線尚未開啟。

範例

以下範例建立導出類別的實例，然後執行該類別 OleDbCommand。 為達成此目的，方法會傳遞一個 SQL SELECT 陳述式的字串，以及一個用來連接資料來源的字串。

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。

適用於