EntityCommand 類別

定義

命名空間:

System.Data.EntityClient

組件:

System.Data.Entity.dll

代表概念層的命令。

C#

public sealed class EntityCommand : System.Data.Common.DbCommand

繼承

Object

MarshalByRefObject

Component

DbCommand

EntityCommand

建構函式

EntityCommand()	使用指定的值，初始化 EntityCommand 類別的新執行個體。
EntityCommand(String)	使用指定的陳述式，初始化 EntityCommand 類別的新執行個體。
EntityCommand(String, EntityConnection)	使用指定的陳述式和連接，初始化 EntityCommand 類別的新執行個體。
EntityCommand(String, EntityConnection, EntityTransaction)	使用指定的陳述式、連接和異動，初始化 EntityCommand 類別的新執行個體。

屬性

CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承來源 Component)
CommandText	取得或設定 Entity SQL 陳述式 (Statement)，這個陳述式會指定要執行的命令或預存程序 (Stored Procedure)。
CommandTimeout	取得或設定在逾時之前要等待的時間。
CommandTree	取得或設定要執行的命令樹；只能設定一個命令樹或命令文字，不能同時設定這兩者。
CommandType	取得或設定值，這個值表示如何解譯 CommandText 屬性。
Connection	取得或設定 EntityConnection 所使用的 EntityCommand。
Container	取得包含 IContainer 的 Component。 (繼承來源 Component)
DbConnection	取得或設定這個 DbConnection 所使用的 DbCommand。 (繼承來源 DbCommand)
DbParameterCollection	取得 DbParameter 物件的集合。 (繼承來源 DbCommand)
DbTransaction	取得或設定 DbTransaction，此 DbCommand 物件會在其中執行。 (繼承來源 DbCommand)
DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component)
DesignTimeVisible	取得或設定值，這個值表示在 Windows Form 設計工具控制項中是否應該看得到命令物件。
EnablePlanCaching	取得或設定值，指出查詢計劃快取是否已啟用。
Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component)
Parameters	取得 Entity SQL 陳述式或預存程序的參數。
Site	取得或設定 Component 的 ISite。 (繼承來源 Component)
Transaction	取得或設定 SqlCommand 執行所在的交易。
UpdatedRowSource	取得或設定命令結果套用至要更新之資料列的方式。

方法

Cancel()	取消執行 EntityCommand。
CreateDbParameter()	建立 DbParameter 物件的新執行個體。 (繼承來源 DbCommand)
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
CreateParameter()	建立 EntityParameter 物件的新執行個體。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承來源 DbCommand)
Dispose(Boolean)	釋放 DbCommand 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 DbCommand)
DisposeAsync()	非同步地處置命令物件。 (繼承來源 DbCommand)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
ExecuteDbDataReader(CommandBehavior)	針對其連線執行命令，傳 DbDataReader 回可用來存取結果的 。 (繼承來源 DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	提供者應該實作這個方法，以提供 ExecuteReader 多載的非預設實作。 預設實作會叫用同步ExecuteReader()方法，並傳回完成的工作，封鎖呼叫的執行緒。 如果傳遞一個已經被取消的取消語彙基元，預設實作會傳回已取消的工作。 ExecuteReader 擲回的例外狀況會透過傳回的 Task Exception 屬性來傳送。 這個方法會接受可以用來要求提早取消作業的取消語彙基元。 實作可以忽略這項要求。 (繼承來源 DbCommand)
ExecuteNonQuery()	執行目前的命令。
ExecuteNonQueryAsync()	異步 ExecuteNonQuery()版本的 ，它會對其連接物件執行命令，並傳回受影響的數據列數目。 以 CancellationToken.None 叫用 ExecuteNonQueryAsync(CancellationToken)。 (繼承來源 DbCommand)
ExecuteNonQueryAsync(CancellationToken)	這是 ExecuteNonQuery() 的非同步版本。 提供者應該覆寫為適當的實作。 可以選擇性地接受忽略語彙基元。 預設實作會叫用同步ExecuteNonQuery()方法，並傳回完成的工作，封鎖呼叫的執行緒。 如果傳遞一個已經被取消的取消語彙基元，預設實作會傳回已取消的工作。 ExecuteNonQuery() 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。 在傳回的工作完成之前，不叫用 DbCommand 物件的其他方法及屬性。 (繼承來源 DbCommand)
ExecuteReader()	執行命令並傳回資料讀取器。
ExecuteReader(CommandBehavior)	將 CommandText 編譯成命令樹，並將其傳遞至基礎存放區提供者來執行，然後使用指定的 EntityDataReader，從產生的結果集中建置 CommandBehavior。
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()	擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetService(Type)	傳回表示 Component 或其 Container 所提供之服務的物件。 (繼承來源 Component)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InitializeLifetimeService()	取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
Prepare()	編譯實體層級命令，並建立命令的備製版本。
PrepareAsync(CancellationToken)	在資料來源上非同步地建立預先準備 (或預先編譯) 版本的命令。 (繼承來源 DbCommand)
ToString()	傳回任何包含 Component 名稱的 String。 不應覆寫此方法。 (繼承來源 Component)
ToTraceString()	編譯實體層級命令並傳回存放區命令文字。

事件

Disposed

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

明確介面實作

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

適用於