IDbCommand.ExecuteNonQuery 方法

定義

命名空間:

System.Data

組件:

System.Data.Common.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。