DbCommand 類別

定義

命名空間:
System.Data.Common
組件:
System.Data.Common.dll
組件:
System.Data.dll
組件:
netstandard.dll

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

public ref class DbCommand abstract : IDisposable
public ref class DbCommand abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, System::Data::IDbCommand
public abstract class DbCommand : IDisposable
public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, System.Data.IDbCommand
type DbCommand = class
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable
Public MustInherit Class DbCommand
Implements IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand
繼承
Object
DbCommand
繼承
Object
MarshalByRefObject
Component
DbCommand
衍生
實作
IDisposable IDbCommand IAsyncDisposable

建構函式

名稱 Description
DbCommand()

建構物件 DbCommand 的實例。

屬性

名稱 Description
CanRaiseEvents

會得到一個值，表示該元件是否能引發事件。

(繼承來源 Component)
CommandText

接收或設定文字指令來對資料來源執行。
CommandTimeout

在終止執行指令並產生錯誤前，先取得或設定等待時間（以秒為單位）。
CommandType

取得或設定該屬性的 CommandText 解讀方式。
Connection

得到或設定 由 DbConnection 所使用 DbCommand。
Container

得到 IContainer 包含 Component的 。

(繼承來源 Component)
DbConnection

得到或設定 由 DbConnection 所使用 DbCommand。
DbParameterCollection

取得物品集合 DbParameter 。
DbTransaction

取得或設定該DbTransaction物件執行的內部。DbCommand
DesignMode

會得到一個值，表示目前 Component 是否處於設計模式。

(繼承來源 Component)
DesignTimeVisible

取得或設定一個值，指示指令物件是否應該在自訂介面控制項中顯示。
Events

會取得與此 Component連結的事件處理程序清單。

(繼承來源 Component)
Parameters

取得物品集合 DbParameter 。 欲了解更多參數資訊，請參閱 「參數配置與參數資料型別」。
Site

取得或設定 ISite 的 Component。

(繼承來源 Component)
Transaction

取得或設定該DbTransaction物件執行的內部。DbCommand
UpdatedRowSource

當 Update 方法DbDataAdapter使用時，指令結果如何套用DataRow或設定 。

方法

名稱 Description
Cancel()

嘗試取消 DbCommand執行 。
CreateDbParameter()

建立一個新的物件實例 DbParameter 。
CreateObjRef(Type)

建立一個物件，包含產生代理伺服器所需的所有相關資訊，用於與遠端物件通訊。

(繼承來源 MarshalByRefObject)
CreateParameter()

建立一個新的物件實例 DbParameter 。
Dispose()

執行與釋放、釋放或重置未管理資源相關的應用程式定義任務。
Dispose()

釋放所有由 Component.

(繼承來源 Component)
Dispose(Boolean)

釋放 未管理的資源， DbCommand 並可選擇性地釋放受管理資源。
Dispose(Boolean)

釋放 未管理的資源， Component 並可選擇性地釋放受管理資源。

(繼承來源 Component)
DisposeAsync()

非同步丟棄指令物件。
Equals(Object)

判斷指定的 物件是否等於目前的物件。

(繼承來源 Object)
ExecuteDbDataReader(CommandBehavior)

對其連線執行指令，回傳可用來存取結果的 a DbDataReader 。
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

提供者應實作此方法，以提供非預設的超載實 ExecuteReader 作。

預設實作會呼叫同步 ExecuteReader() 方法並回傳已完成的任務，阻擋呼叫執行緒。 預設實作若傳遞已取消的取消標記，會回傳已取消的任務。 ExecuteReader 拋出的異常會透過回傳的任務異常屬性來傳達。

此方法接受一個取消標記，可用來請求提前取消操作。 實施單位可能會忽略此請求。
ExecuteNonQuery()

對其連接物件執行指令，回傳受影響的列數。
ExecuteNonQueryAsync()

非同步版本 ExecuteNonQuery()的 ，該指令會對其連接物件執行指令，並回傳受影響的列數。

使用 CancellationToken.None 來調用 ExecuteNonQueryAsync(CancellationToken) 。
ExecuteNonQueryAsync(CancellationToken)

這是非同步版本的 ExecuteNonQuery()。 提供者應該透過適當的實作來覆蓋。 取消標記可選擇性地忽略。

預設實作會呼叫同步 ExecuteNonQuery() 方法並回傳已完成的任務，阻擋呼叫執行緒。 預設實作若傳遞已取消的取消標記，會回傳已取消的任務。 所 ExecuteNonQuery() 拋出的異常會透過回傳的 Task Exception 屬性來傳達。

在回傳任務完成前，不要呼叫物件的其他 DbCommand 方法和屬性。
ExecuteReader()

對其連線執行指令，回傳可用來存取結果的 a DbDataReader 。
ExecuteReader(CommandBehavior)

對其連線執行指令，回傳可用來存取結果的 a DbDataReader 。
ExecuteReaderAsync()

一個非同步版本 ExecuteReader的 ，該指令會對其連線執行指令，回傳 a DbDataReader 可用來存取結果。

使用 CancellationToken.None 來調用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) 。
ExecuteReaderAsync(CancellationToken)

一個非同步版本 ExecuteReader的 ，該指令會對其連線執行指令，回傳 a DbDataReader 可用來存取結果。

喚起 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。
ExecuteReaderAsync(CommandBehavior, CancellationToken)

喚起 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。
ExecuteReaderAsync(CommandBehavior)

一個非同步版本 ExecuteReader的 ，該指令會對其連線執行指令，回傳 a DbDataReader 可用來存取結果。

喚起 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()

傳回表示目前 物件的字串。

(繼承來源 Object)
ToString()

回傳 String 包含 的名稱 Component（若有的話）。 此方法不應被覆蓋。

(繼承來源 Component)

事件

名稱 Description
Disposed

當元件被呼叫方法 Dispose() 時會發生。

(繼承來源 Component)

明確介面實作

名稱 Description
IDbCommand.Connection

取得或設定 IDbConnection 此實例 IDbCommand所使用的。
IDbCommand.CreateParameter()

建立一個新的物件實例 IDbDataParameter 。
IDbCommand.ExecuteReader()

執行 對 CommandText 並 Connection 構建 IDataReader。
IDbCommand.ExecuteReader(CommandBehavior)

對 執行 ，CommandTextConnection並利用其中一個IDataReader值建立 CommandBehavior 。
IDbCommand.Parameters

取得 IDataParameterCollection。
IDbCommand.Transaction

取得或設定該DbTransaction物件執行的內部。DbCommand

擴充方法

名稱 Description
ConfigureAwait(IAsyncDisposable, Boolean)

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

適用於

另請參閱