OdbcCommand 類別

定義

命名空間:

System.Data.Odbc

組件:

System.Data.Odbc.dll

套件:

System.Data.Odbc v11.0.0-preview.4.26230.115

來源:

OdbcCommand.cs

表示要針對數據源執行的 SQL 語句或預存程式。 此類別無法獲得繼承。

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable

public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

繼承

Object

DbCommand

OdbcCommand

實作

ICloneable

範例

下列範例使用 ExecuteNonQuery。

public void InsertRow(string connectionString, string insertSQL)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OdbcCommand command = new OdbcCommand(insertSQL, connection);

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OdbcConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OdbcCommand(insertSQL, connection)

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

備註

該 OdbcCommand 類別提供以下方法用於對資料來源執行指令：

Item	Description
ExecuteReader	執行回傳列的指令。
ExecuteNonQuery	執行 SQL INSERT、DELETE、UPDATE 和 SET 等指令。
ExecuteScalar	從資料庫擷取單一值，例如匯總值。

你可以重置屬性 CommandText 並重複使用該 OdbcCommand 物件。 不過，你必須先關閉 ， OdbcDataReader 才能執行新的或之前的指令。

若執行指令時發生致命事件 OdbcException ，例如 SQL Server 嚴重度等級達 20 或以上， OdbcConnection 可能會關閉。 不過，用戶可以重新開啟連線並繼續。

建構函式

名稱	Description
OdbcCommand()	初始化 OdbcCommand 類別的新執行個體。
OdbcCommand(String, OdbcConnection, OdbcTransaction)	初始化一個新的類別實例 OdbcCommand ，包含查詢文本、一個 OdbcConnection 物件和 Transaction。
OdbcCommand(String, OdbcConnection)	初始化一個新的類別實例 OdbcCommand ，包含查詢文本與物件 OdbcConnection 。
OdbcCommand(String)	初始化一個新的類別實例 OdbcCommand ，並使用查詢的文字。

屬性

名稱	Description
CommandText	取得或設定 SQL 陳述式或儲存程序，使其對資料來源執行。
CommandTimeout	取得或設定終止嘗試執行命令併產生錯誤之前的等候時間（以秒為單位）。
CommandType	取得或設定一個值，指示屬性的 CommandText 解讀方式。
Connection	取得或設定 OdbcConnection 此實例 OdbcCommand所使用的。
DesignTimeVisible	取得或設定值，這個值表示命令物件是否應該顯示在自定義介面控件中。
Parameters	取得 OdbcParameterCollection。
Transaction	取得或設定 OdbcTransaction 執行的內部 OdbcCommand 。
UpdatedRowSource	取得或設定一個值，指定 更新 方法如何將指令結果套用到 DataRow。

方法

名稱	Description
Cancel()	嘗試取消執行 OdbcCommand。
CreateParameter()	建立一個新的物件實例 OdbcParameter 。
ExecuteNonQuery()	對 執行 SQL 陳述式， Connection 並回傳受影響的列數。
ExecuteReader()	將 CommandText 傳送到 並 Connection 建立一個 OdbcDataReader。
ExecuteReader(CommandBehavior)	將 CommandText 傳送到 Connection，並利用其中一個OdbcDataReader值建立 CommandBehavior 。
ExecuteScalar()	執行查詢，並回傳查詢回傳結果集第一列的第一欄。 額外的欄位或列則被忽略。
Prepare()	在數據源建立已備妥或編譯的命令版本。
ResetCommandTimeout()	將屬性 CommandTimeout 重置為預設值。

明確介面實作

名稱	Description
ICloneable.Clone()	關於此成員的描述，請參見 Clone()。

另請參閱

• OdbcDataAdapter
• OdbcConnection
• 執行命令