OracleCommand.ExecuteNonQuery 方法

定義

命名空間:

System.Data.OracleClient

組件:

System.Data.OracleClient.dll

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

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

傳回

Int32

對 UPDATE、INSERT 和 DELETE 陳述式而言，傳回值是受命令影響的資料列數目。 對於 CREATE TABLE 和 DROP TABLE 陳述式，傳回值為 0。 對其他類型的陳述式而言，傳回值為 -1。

例外狀況

InvalidOperationException

連接不存在。

-或-

連接未開啟。

範例

下列範例會 OracleCommand 建立 ，然後使用 來執行它 ExecuteNonQuery。 此範例會傳遞 SQL 語句的字串， (例如 UPDATE、INSERT 或 DELETE) ，以及用來連接到資料庫的字串。

public void CreateOracleCommand(string myExecuteQuery, string connectionString)
{
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(myExecuteQuery, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

Public Sub CreateOracleCommand(ByVal myExecuteQuery As String, _
ByVal connectionString As String)
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(myExecuteQuery, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

備註

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

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

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

另請參閱

• 使用命令