EntityDataReader 類別

定義

命名空間:: System.Data.EntityClient

組件:: System.Data.Entity.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

從數據源讀取數據列的正向數據流。

public ref class EntityDataReader : System::Data::Common::DbDataReader, System::Data::IExtendedDataRecord

public class EntityDataReader : System.Data.Common.DbDataReader, System.Data.IExtendedDataRecord

type EntityDataReader = class
    inherit DbDataReader
    interface IExtendedDataRecord
    interface IDataRecord

Public Class EntityDataReader
Inherits DbDataReader
Implements IExtendedDataRecord

繼承: Object

MarshalByRefObject

DbDataReader
EntityDataReader

實作: IDataRecord IExtendedDataRecord

備註

結合了類別的功能 DbDataReader 與 IExtendedDataRecord 介面。

安 EntityDataReader 沒有公開的建構器。只能透過其中一個 EntityCommand.ExecuteReader 方法的超載獲得。

SQL Server 會在結果串流的末尾，將儲存程序的輸出參數放在所有結果集之後。因此，為了取得輸出參數值，應用程式必須消耗所有結果集中的所有記錄。如果應用程式關閉 EntityDataReader 了（也會關閉 DbDataReader），輸出參數可能無法被填入。

EntityDataReader 不會隱含使用結果集以提供輸出參數。因此，請注意以下幾點：

EntityDataReader只有在EntityDataReader.NextResult明確被呼叫時才會呼叫DbDataReader.NextResult。如果 DbDataReader.NextResult 拋出例外，會 EntityDataReader 將其包裹在 EntityException 一個（或衍生例外）中。
Close 只會關閉 DbDataReader，且不會消耗任何待處理的記錄或結果集。
Dispose 僅處理 DbDataReader，且不消耗任何待處理的記錄或結果集。

關於程式碼範例，請參見「與 EntityClient 合作」。

屬性

名稱	Description
DataRecordInfo	為了這個IExtendedDataRecord。DataRecordInfo
Depth	會獲得當前列巢狀深度的值。
FieldCount	取得目前數據列中的數據行數目。
HasRows	會得到一個值，表示該資料 EntityDataReader 是否包含一列或多列。
IsClosed	會得到一個值，表示是否 EntityDataReader 封閉。
Item[Int32]	取得指定欄位的值，作為的 Object實例。
Item[String]	取得指定欄位的值，作為的 Object實例。
RecordsAffected	取得執行 SQL 陳述句時所變更、插入或刪除的列數。
VisibleFieldCount	取得中未被隱藏的欄位 EntityDataReader 數量。

方法

名稱	Description
Close()	關閉 EntityDataReader 物件。
CreateObjRef(Type)	建立一個物件，包含產生代理伺服器所需的所有相關資訊，用於與遠端物件通訊。 (繼承來源 MarshalByRefObject)
Dispose()	釋放目前類別實例 DbDataReader 所使用的所有資源。 (繼承來源 DbDataReader)
Dispose(Boolean)	釋放被 EntityDataReader 此消耗的資源並呼叫 Close()。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetBoolean(Int32)	取得指定之數據行的值做為布爾值。
GetByte(Int32)	取得指定數據行的值做為位元組。
GetBytes(Int32, Int64, Byte[], Int32, Int32)	從指定欄位讀取一串位元組，從所示 `dataOffset`位置開始，進入緩衝區，從指示 `bufferOffset`的位置開始。
GetChar(Int32)	以單一字元的形式取得指定欄位的值。
GetChars(Int32, Int64, Char[], Int32, Int32)	從指定欄位讀取一串字元，從所 `dataOffset`指示的位置開始，進入緩衝區，從所示 `bufferOffset`位置開始。
GetData(Int32)	回傳所請求欄位的巢狀資料讀取器。 (繼承來源 DbDataReader)
GetDataReader(Int32)	將巢狀讀取器以 DbDataReader 物件回傳。
GetDataRecord(Int32)	返回巢狀 DbDataRecord的。
GetDataTypeName(Int32)	取得指定欄位的資料型態名稱。
GetDateTime(Int32)	取得指定欄位的值作為 DateTime 物件。
GetDbDataReader(Int32)	回傳 DbDataReader 請求欄位序數的物件，該物件可用提供者專屬實作覆寫。
GetDecimal(Int32)	取得指定欄位的值作為 Decimal 物件。
GetDouble(Int32)	取得指定欄位的值，為雙精度浮點數。
GetEnumerator()	回傳和 IEnumerator 可用於資料讀取器中遍歷各列。
GetFieldType(Int32)	取得指定欄位的資料型態。
GetFieldValue<T>(Int32)	取得指定數據行的值做為要求的型別。 (繼承來源 DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	以異步方式取得指定數據行的值做為要求的型別。 (繼承來源 DbDataReader)
GetFieldValueAsync<T>(Int32)	以異步方式取得指定數據行的值做為要求的型別。 (繼承來源 DbDataReader)
GetFloat(Int32)	取得指定欄位的值為單精度浮點數。
GetGuid(Int32)	取得指定欄位的值作為全域唯一識別碼（GUID）。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetInt16(Int32)	取得指定數據行的值，做為16位帶正負號的整數。
GetInt32(Int32)	取得指定數據行的值，做為32位帶正負號的整數。
GetInt64(Int32)	取得指定數據行的值，做為64位帶正負號的整數。
GetLifetimeService()	取得目前控制此實例生命週期政策的終身服務物件。 (繼承來源 MarshalByRefObject)
GetName(Int32)	給定以零為基礎的列序數，得到該欄的名稱。
GetOrdinal(String)	得到欄位序數，該欄位名稱相同。
GetProviderSpecificFieldType(Int32)	回傳指定欄位的提供者專屬欄位類型。
GetProviderSpecificValue(Int32)	取得指定欄位的值，作為的 Object實例。
GetProviderSpecificValues(Object[])	取得目前數據列集合中的所有提供者特定屬性數據行。
GetSchemaTable()	回傳描述欄位元資料DataTable的 aDbDataReader。
GetStream(Int32)	取得數據流，以從指定的數據行擷取數據。 (繼承來源 DbDataReader)
GetString(Int32)	取得指定欄位的值，作為的 String實例。
GetTextReader(Int32)	取得文字讀取器，以從數據行擷取數據。 (繼承來源 DbDataReader)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
GetValue(Int32)	取得指定欄位的值，作為的 Object實例。
GetValues(Object[])	使用目前數據列的數據行值填入物件的陣列。
InitializeLifetimeService()	取得一個終身服務物件以控制此實例的終身政策。 (繼承來源 MarshalByRefObject)
IsDBNull(Int32)	取得值，這個值表示數據行是否包含不存在或遺漏的值。
IsDBNullAsync(Int32, CancellationToken)	以異步方式取得值，指出數據行是否包含不存在或遺漏的值。 (繼承來源 DbDataReader)
IsDBNullAsync(Int32)	以異步方式取得值，指出數據行是否包含不存在或遺漏的值。 (繼承來源 DbDataReader)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立一個 MarshalByRefObject 目前物件的淺層複製品。 (繼承來源 MarshalByRefObject)
NextResult()	讀取一組語句結果時，會將讀者推進到下一個結果。
NextResultAsync()	讀取語句批次的結果時，以異步方式將讀取器前進到下一個結果。 (繼承來源 DbDataReader)
NextResultAsync(CancellationToken)	讀取語句批次的結果時，以異步方式將讀取器前進到下一個結果。 (繼承來源 DbDataReader)
Read()	將讀取器推進到結果集中的下一個記錄。
ReadAsync()	以異步方式將讀取器前進到結果集中的下一筆記錄。 (繼承來源 DbDataReader)
ReadAsync(CancellationToken)	以異步方式將讀取器前進到結果集中的下一筆記錄。 (繼承來源 DbDataReader)
ToString()	傳回表示目前物件的字串。 (繼承來源 Object)

明確介面實作

名稱	Description
IDataRecord.GetData(Int32)	關於此成員的描述，請參見 GetData(Int32)。 (繼承來源 DbDataReader)

擴充方法

名稱	Description
AsParallel(IEnumerable)	啟用查詢的平行處理。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。
CanGetColumnSchema(DbDataReader)	會得到一個值，表示 a DbDataReader 是否能取得欄位結構。
Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
GetColumnSchema(DbDataReader)	取得欄位結構（DbColumn 集合）的 DbDataReader。
OfType<TResult>(IEnumerable)	根據指定的型別篩選 IEnumerable 的專案。

適用於

意見反應

此頁面對您有幫助嗎？