OleDbCommand 類別

定義

命名空間:

System.Data.OleDb

組件:

System.Data.OleDb.dll

套件:

System.Data.OleDb v9.0.0-rc.1.24431.7

來源:

OleDbCommand.cs

表示要針對數據源執行的 SQL 語句或預存程式。

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable

public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

繼承

Object

MarshalByRefObject

Component

DbCommand

OleDbCommand

實作

IDbCommand ICloneable IDisposable

範例

下列範例會使用 OleDbCommand和 OleDbDataAdapter 和 OleDbConnection，從 Access 資料庫中選取數據列。 接著會傳回填入 DataSet。 此範例會傳遞初始化 DataSet、連接字串、SQL SELECT 語句的查詢字串，以及源資料庫數據表名稱的字串串。

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}

Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

備註

建立 OleDbCommand 實例時，讀取/寫入屬性會設定為其初始值。 如需這些值的清單，請參閱 OleDbCommand 建構函式。

OleDbCommand 下列方法會在資料源上執行命令：

專案	描述
ExecuteReader	執行傳回數據列的命令。 ExecuteReader 在用來執行 SQL SET 語句等命令時，可能沒有您想要的效果。
ExecuteNonQuery	執行 SQL INSERT、DELETE、UPDATE 和 SET 語句等命令。
ExecuteScalar	擷取單一值，例如，從資料庫擷取匯總值。

您可以重設 CommandText 屬性，並重複使用 OleDbCommand 物件。 不過，您必須先關閉 OleDbDataReader，才能執行新的或先前的命令。

如果嚴重 OleDbException（例如，SQL Server 嚴重性層級為 20 或更新版本）是由執行 OleDbCommand的方法所產生，OleDbConnection，則連接可能會關閉。 不過，用戶可以重新開啟連線並繼續。

建構函式

OleDbCommand()	初始化 OleDbCommand 類別的新實例。
OleDbCommand(String)	使用查詢的文字，初始化 OleDbCommand 類別的新實例。
OleDbCommand(String, OleDbConnection)	使用查詢的文字和 OleDbConnection，初始化 OleDbCommand 類別的新實例。
OleDbCommand(String, OleDbConnection, OleDbTransaction)	使用查詢文字、OleDbConnection和 Transaction，初始化 OleDbCommand 類別的新實例。

屬性

CanRaiseEvents	取得值，指出元件是否可以引發事件。 (繼承來源 Component)
CommandText	取得或設定要於數據源執行的 SQL 語句或預存程式。
CommandTimeout	取得或設定終止嘗試執行命令併產生錯誤之前的等候時間（以秒為單位）。
CommandType	取得或設定值，這個值表示如何解譯 CommandText 屬性。
Connection	取得或設定這個 OleDbCommand實例所使用的 OleDbConnection。
Container	取得包含 Component的 IContainer。 (繼承來源 Component)
DbConnection	取得或設定這個 DbCommand所使用的 DbConnection。 (繼承來源 DbCommand)
DbParameterCollection	取得 DbParameter 物件的集合。 (繼承來源 DbCommand)
DbTransaction	取得或設定這個 DbCommand 物件執行所在的 DbTransaction。 (繼承來源 DbCommand)
DesignMode	取得值，這個值表示 Component 目前是否處於設計模式。 (繼承來源 Component)
DesignTimeVisible	取得或設定值，這個值表示命令物件是否應該顯示在自定義的 Windows Forms 設計工具控制件中。
Events	取得附加至這個 Component之事件處理程序的清單。 (繼承來源 Component)
Parameters	取得 OleDbParameterCollection。
Site	取得或設定 Component的 ISite。 (繼承來源 Component)
Transaction	取得或設定 OleDbCommand 執行所在的 OleDbTransaction。
UpdatedRowSource	取得或設定當 OleDbDataAdapter的 Update 方法使用時，命令結果如何套用至 DataRow。

方法

Cancel()	試著取消執行 OleDbCommand。
Clone()	建立新的 OleDbCommand 物件，該物件是目前實例的複本。
CreateDbParameter()	建立 DbParameter 物件的新實例。 (繼承來源 DbCommand)
CreateObjRef(Type)	建立物件，其中包含產生用來與遠端物件通訊之 Proxy 所需的所有相關信息。 (繼承來源 MarshalByRefObject)
CreateParameter()	建立 OleDbParameter 物件的新實例。
Dispose()	執行與釋放、釋放或重設非受控資源相關聯的應用程式定義工作。 (繼承來源 DbCommand)
Dispose(Boolean)	釋放 DbCommand 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 DbCommand)
DisposeAsync()	以異步方式將命令物件浸入。 (繼承來源 DbCommand)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
ExecuteDbDataReader(CommandBehavior)	針對其連線執行命令，傳回可用來存取結果的 DbDataReader。 (繼承來源 DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	提供者應該實作這個方法，以提供 ExecuteReader 多載的非預設實作。 默認實作會叫用同步 ExecuteReader() 方法，並傳回已完成的工作，並封鎖呼叫線程。 如果傳遞已取消的取消標記，默認實作會傳回已取消的工作。 ExecuteReader 擲回的例外狀況將會透過傳回的工作例外狀況屬性進行通訊。 此方法接受取消令牌，可用來要求提前取消作業。 實作可能會忽略此要求。 (繼承來源 DbCommand)
ExecuteNonQuery()	針對 Connection 執行 SQL 語句，並傳回受影響的數據列數目。
ExecuteNonQueryAsync()	異步版本的 ExecuteNonQuery()，它會對其連接物件執行命令，並傳回受影響的數據列數目。 使用 CancellationToken.None 叫用 ExecuteNonQueryAsync(CancellationToken)。 (繼承來源 DbCommand)
ExecuteNonQueryAsync(CancellationToken)	這是 ExecuteNonQuery()的異步版本。 提供者應該以適當的實作覆寫。 您可以選擇性地忽略取消令牌。 默認實作會叫用同步 ExecuteNonQuery() 方法，並傳回已完成的工作，並封鎖呼叫線程。 如果傳遞已取消的取消標記，默認實作會傳回已取消的工作。 ExecuteNonQuery() 擲回的例外狀況將會透過傳回的工作例外狀況屬性進行通訊。 在傳回的工作完成之前，請勿叫用 DbCommand 物件的其他方法和屬性。 (繼承來源 DbCommand)
ExecuteReader()	將 CommandText 傳送至 Connection，並建置 OleDbDataReader。
ExecuteReader(CommandBehavior)	將 CommandText 傳送至 Connection，並使用其中一個 CommandBehavior 值來建置 OleDbDataReader。
ExecuteReaderAsync()	異步版本的 ExecuteReader，它會對其連線執行命令，並傳回可用來存取結果的 DbDataReader。 使用 CancellationToken.None 叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。 (繼承來源 DbCommand)
ExecuteReaderAsync(CancellationToken)	異步版本的 ExecuteReader，它會對其連線執行命令，並傳回可用來存取結果的 DbDataReader。 叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。 (繼承來源 DbCommand)
ExecuteReaderAsync(CommandBehavior)	異步版本的 ExecuteReader，它會對其連線執行命令，並傳回可用來存取結果的 DbDataReader。 叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。 (繼承來源 DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。 (繼承來源 DbCommand)
ExecuteScalar()	執行查詢，並傳回查詢所傳回結果集中第一個數據列的第一個數據行。 會忽略其他數據行或數據列。
ExecuteScalarAsync()	異步版本的 ExecuteScalar()，它會執行 命令，並傳回第一個傳回結果集中第一個數據列的第一個數據行。 會忽略所有其他數據行、數據列和結果集。 使用 CancellationToken.None 叫用 ExecuteScalarAsync(CancellationToken)。 (繼承來源 DbCommand)
ExecuteScalarAsync(CancellationToken)	這是 ExecuteScalar()的異步版本。 提供者應該以適當的實作覆寫。 您可以選擇性地忽略取消令牌。 默認實作會叫用同步 ExecuteScalar() 方法，並傳回已完成的工作，並封鎖呼叫線程。 如果傳遞已取消的取消標記，默認實作會傳回已取消的工作。 ExecuteScalar 擲回的例外狀況將會透過傳回的工作例外狀況屬性進行通訊。 在傳回的工作完成之前，請勿叫用 DbCommand 物件的其他方法和屬性。 (繼承來源 DbCommand)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 擷取控制這個實例存留期原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetService(Type)	傳回 物件，表示 Component 或其 Container所提供的服務。 (繼承來源 Component)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
InitializeLifetimeService()	已淘汰. 取得存留期服務物件，以控制這個實例的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 對象的淺層複本。 (繼承來源 MarshalByRefObject)
Prepare()	在數據源上建立已備妥或已編譯的命令版本。
PrepareAsync(CancellationToken)	以異步方式在數據源上建立已備妥或已編譯的命令版本。 (繼承來源 DbCommand)
ResetCommandTimeout()	將 CommandTimeout 屬性重設為預設值。
ToString()	傳回包含 Component名稱的 String，如果有的話。 不應該覆寫這個方法。 (繼承來源 Component)

事件

Disposed

當呼叫 Dispose() 方法時，就會發生元件。 (繼承來源 Component)

明確介面實作

ICloneable.Clone()	如需此成員的描述，請參閱 Clone()。
IDbCommand.Connection	取得或設定這個 IDbCommand實例所使用的 IDbConnection。 (繼承來源 DbCommand)
IDbCommand.CreateParameter()	建立 IDbDataParameter 物件的新實例。 (繼承來源 DbCommand)
IDbCommand.ExecuteReader()	如需此成員的描述，請參閱 ExecuteReader()。
IDbCommand.ExecuteReader(CommandBehavior)	針對 Connection執行 CommandText，並使用其中一個 CommandBehavior 值來建置 IDataReader。
IDbCommand.Parameters	取得 IDataParameterCollection。 (繼承來源 DbCommand)
IDbCommand.Transaction	取得或設定這個 DbCommand 物件執行所在的 DbTransaction。 (繼承來源 DbCommand)

擴充方法

ConfigureAwait(IAsyncDisposable, Boolean)

設定如何執行從異步可處置專案傳回的工作等候。

另請參閱

• OleDbDataAdapter
• OleDbConnection
• 使用命令