DbCommand 類別

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

來源:

DbCommand.cs

表示要針對數據源執行的 SQL 語句或預存程式。 提供代表命令之資料庫特定類別的基類。 ExecuteNonQueryAsync。

public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbCommand

public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbCommand

type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand, IDisposable

繼承

Object

MarshalByRefObject

Component

DbCommand

衍生

System.Data.EntityClient.EntityCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.SqlClient.SqlCommand

實作

IDisposable IDbCommand IAsyncDisposable

建構函式

DbCommand()

建構 DbCommand 對象的實例。

屬性

CanRaiseEvents	取得值，指出元件是否可以引發事件。 (繼承來源 Component)
CommandText	取得或設定要針對數據源執行的文字命令。
CommandTimeout	取得或設定終止嘗試執行命令併產生錯誤之前的等候時間（以秒為單位）。
CommandType	取得或設定如何解譯 CommandText 屬性。
Connection	取得或設定這個 DbCommand所使用的 DbConnection。
Container	取得包含 Component的 IContainer。 (繼承來源 Component)
DbConnection	取得或設定這個 DbCommand所使用的 DbConnection。
DbParameterCollection	取得 DbParameter 物件的集合。
DbTransaction	取得或設定這個 DbCommand 物件執行所在的 DbTransaction。
DesignMode	取得值，這個值表示 Component 目前是否處於設計模式。 (繼承來源 Component)
DesignTimeVisible	取得或設定值，指出命令物件是否應該顯示在自定義介面控件中。
Events	取得附加至這個 Component之事件處理程序的清單。 (繼承來源 Component)
Parameters	取得 DbParameter 物件的集合。 如需參數的詳細資訊，請參閱 設定參數和參數資料類型。
Site	取得或設定 Component的 ISite。 (繼承來源 Component)
Transaction	取得或設定這個 DbCommand 物件執行所在的 DbTransaction。
UpdatedRowSource	取得或設定當 DbDataAdapter的 Update 方法使用時，命令結果如何套用至 DataRow。

方法

Cancel()	試著取消執行 DbCommand。
CreateDbParameter()	建立 DbParameter 物件的新實例。
CreateObjRef(Type)	建立物件，其中包含產生用來與遠端物件通訊之 Proxy 所需的所有相關信息。 (繼承來源 MarshalByRefObject)
CreateParameter()	建立 DbParameter 物件的新實例。
Dispose()	釋放 Component所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	釋放 Component 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 Component)
DisposeAsync()	以異步方式將命令物件浸入。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
ExecuteDbDataReader(CommandBehavior)	針對其連線執行命令，傳回可用來存取結果的 DbDataReader。
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	提供者應該實作這個方法，以提供 ExecuteReader 多載的非預設實作。 默認實作會叫用同步 ExecuteReader() 方法，並傳回已完成的工作，並封鎖呼叫線程。 如果傳遞已取消的取消標記，默認實作會傳回已取消的工作。 ExecuteReader 擲回的例外狀況將會透過傳回的工作例外狀況屬性進行通訊。 此方法接受取消令牌，可用來要求提前取消作業。 實作可能會忽略此要求。
ExecuteNonQuery()	針對其連接物件執行 命令，並傳回受影響的數據列數目。
ExecuteNonQueryAsync()	異步版本的 ExecuteNonQuery()，它會對其連接物件執行命令，並傳回受影響的數據列數目。 使用 CancellationToken.None 叫用 ExecuteNonQueryAsync(CancellationToken)。
ExecuteNonQueryAsync(CancellationToken)	這是 ExecuteNonQuery()的異步版本。 提供者應該以適當的實作覆寫。 您可以選擇性地忽略取消令牌。 默認實作會叫用同步 ExecuteNonQuery() 方法，並傳回已完成的工作，並封鎖呼叫線程。 如果傳遞已取消的取消標記，默認實作會傳回已取消的工作。 ExecuteNonQuery() 擲回的例外狀況將會透過傳回的工作例外狀況屬性進行通訊。 在傳回的工作完成之前，請勿叫用 DbCommand 物件的其他方法和屬性。
ExecuteReader()	針對其連線執行命令，傳回可用來存取結果的 DbDataReader。
ExecuteReader(CommandBehavior)	針對其連線執行命令，傳回可用來存取結果的 DbDataReader。
ExecuteReaderAsync()	異步版本的 ExecuteReader，它會對其連線執行命令，並傳回可用來存取結果的 DbDataReader。 使用 CancellationToken.None 叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。
ExecuteReaderAsync(CancellationToken)	異步版本的 ExecuteReader，它會對其連線執行命令，並傳回可用來存取結果的 DbDataReader。 叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。
ExecuteReaderAsync(CommandBehavior)	異步版本的 ExecuteReader，它會對其連線執行命令，並傳回可用來存取結果的 DbDataReader。 叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。
ExecuteReaderAsync(CommandBehavior, CancellationToken)	叫用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。
ExecuteScalar()	執行 命令，並傳回第一個傳回結果集中第一個數據列的第一個數據行。 會忽略所有其他數據行、數據列和結果集。
ExecuteScalarAsync()	異步版本的 ExecuteScalar()，它會執行 命令，並傳回第一個傳回結果集中第一個數據列的第一個數據行。 會忽略所有其他數據行、數據列和結果集。 使用 CancellationToken.None 叫用 ExecuteScalarAsync(CancellationToken)。
ExecuteScalarAsync(CancellationToken)	這是 ExecuteScalar()的異步版本。 提供者應該以適當的實作覆寫。 您可以選擇性地忽略取消令牌。 默認實作會叫用同步 ExecuteScalar() 方法，並傳回已完成的工作，並封鎖呼叫線程。 如果傳遞已取消的取消標記，默認實作會傳回已取消的工作。 ExecuteScalar 擲回的例外狀況將會透過傳回的工作例外狀況屬性進行通訊。 在傳回的工作完成之前，請勿叫用 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)	以異步方式在數據源上建立已備妥或已編譯的命令版本。
ToString()	傳回包含 Component名稱的 String，如果有的話。 不應該覆寫這個方法。 (繼承來源 Component)

事件

Disposed

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

明確介面實作

IDbCommand.Connection	取得或設定這個 IDbCommand實例所使用的 IDbConnection。
IDbCommand.CreateParameter()	建立 IDbDataParameter 物件的新實例。
IDbCommand.ExecuteReader()	針對 Connection 執行 CommandText，並建置 IDataReader。
IDbCommand.ExecuteReader(CommandBehavior)	針對 Connection執行 CommandText，並使用其中一個 CommandBehavior 值來建置 IDataReader。
IDbCommand.Parameters	取得 IDataParameterCollection。
IDbCommand.Transaction	取得或設定這個 DbCommand 物件執行所在的 DbTransaction。

擴充方法

ConfigureAwait(IAsyncDisposable, Boolean)

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

另請參閱

• ADO.NET 概觀