AdomdDataReader 類別

提供方法來讀取透過執行命令取得用來存取多維度資料來源的順向結果集。

繼承階層

Object
  MarshalByRefObject
    Microsoft.AnalysisServices.AdomdServer.AdomdDataReader

命名空間：  Microsoft.AnalysisServices.AdomdServer
組件：  msmgdsrv (在 msmgdsrv.dll 中)

語法

'宣告
Public NotInheritable Class AdomdDataReader _
    Inherits MarshalByRefObject _
    Implements IDataReader, IDisposable, IDataRecord, IEnumerable
'用途
Dim instance As AdomdDataReader

public sealed class AdomdDataReader : MarshalByRefObject, 
    IDataReader, IDisposable, IDataRecord, IEnumerable

public ref class AdomdDataReader sealed : public MarshalByRefObject, 
    IDataReader, IDisposable, IDataRecord, IEnumerable

[<SealedAttribute>]
type AdomdDataReader =  
    class 
        inherit MarshalByRefObject 
        interface IDataReader 
        interface IDisposable 
        interface IDataRecord 
        interface IEnumerable 
    end

public final class AdomdDataReader extends MarshalByRefObject implements IDataReader, IDisposable, IDataRecord, IEnumerable

AdomdDataReader 型別公開下列成員。

屬性

	名稱	說明
	Depth	取得值，表示目前資料列的巢狀深度。
	FieldCount	取得值，表示目前資料列的資料行數。
	IsClosed	取得值，表示資料讀取器是否已關閉。
	Item[Int32]	提供資料行的序數位置，取得原生格式的指定資料行值。在 Microsoft Visual C# 中，這個屬性是 T:Microsoft.AnalysisServices.AdomdServer.AdomdDataReader 類別的索引子。
	Item[String]	提供資料行名稱，取得原生格式的指定資料行值。在 Microsoft Visual C# 中，這個屬性是 AdomdDataReader 類別的索引子。
	RecordsAffected	這個成員保留供未來使用。

回到頁首

方法

	名稱	說明
	{dtor}	此方法僅供內部使用。
	Close	關閉 AdomdDataReader。
	CreateObjRef	安全性關鍵。 (繼承自 MarshalByRefObject。)
	Dispose	釋放 AdomdDataReader 使用的所有資源。
	Equals	(繼承自 Object。)
	GetBoolean	傳回 Boolean，其中包含指定之資料行的值。
	GetByte	傳回 Byte，其中包含指定之資料行的值。
	GetBytes	這個成員保留供未來使用。
	GetChar	傳回 Char，其中包含指定之資料行的值。
	GetChars	傳回 Char 物件陣列，其中包含指定之資料行的值資料流。
	GetData	傳回資料行指向多項遠端結構化資料時要使用的 System.Data.IDataReader 介面。
	GetDataReader	從指定的資料行取得 AdomdDataReader 物件。
	GetDataTypeName	傳回 String，其中包含指定之資料行的資料類型完整名稱。
	GetDateTime	傳回 DateTime，其中包含指定之資料行的值。
	GetDecimal	傳回 Decimal，其中包含指定之資料行的值。
	GetDouble	傳回 Double，其中包含指定之資料行的值。
	GetEnumerator	取得可逐一查看集合的 IEnumerator 介面。
	GetFieldType	傳回 Type，這個類型代表指定之資料行的資料類型。
	GetFloat	傳回 Float，其中包含指定之資料行的值。
	GetGuid	傳回 Guid，其中包含指定之資料行的值。
	GetHashCode	(繼承自 Object。)
	GetInt16	傳回 Int16，其中包含指定之資料行的值。
	GetInt32	傳回 Int32，其中包含指定之資料行的值。
	GetInt64	傳回 Int64，其中包含指定之資料行的值。
	GetLifetimeService	安全性關鍵。 (繼承自 MarshalByRefObject。)
	GetName	傳回指定之資料行的名稱。
	GetOrdinal	傳回指定之資料行的序數位置。
	GetSchemaTable	傳回 DataTable，描述 AdomdDataReader 的資料行中繼資料。
	GetString	傳回 String，其中包含指定之資料行的值。
	GetTimeSpan	取得 TimeSpan，其中包含指定之資料行的值。
	GetType	(繼承自 Object。)
	GetValue	傳回原生格式的指定資料行值。
	GetValues	取得目前資料列中之所有資料行的值陣列。
	InitializeLifetimeService	安全性關鍵。 (繼承自 MarshalByRefObject。)
	IsDBNull	傳回 Boolean，這個值表示資料行是否設為 null。
	NextResult	這個成員保留供未來使用。
	Read	將 AdomdDataReader 向前移到下一個資料列。
	ToString	(繼承自 Object。)

回到頁首

備註

AdomdDataReader 類別是 [System.Data.IDataReader] 介面的 ADOMD.NET 實作。 所有 Microsoft .NET 資料提供者都實作 [System.Data.IDataReader] 介面做為快速讀取順向結果集的方式。

若要建立 AdomdDataReader，您必須呼叫 AdomdCommand 的 ExecuteReader 方法，而不是直接使用建構函式。

當正在使用 AdomdDataReader 時，AdomdCommand 和相關聯的 AdomdConnection 都將忙於處理 AdomdDataReader。 一旦處在這種狀態下，則除了關閉 AdomdConnection 或 AdomdCommand 物件外，一概無法對這些物件執行任何作業。 此情況將持續到呼叫 AdomdDataReader 的 Close 或 Dispose 方法為止。 另一個處理序或執行緒在資料讀取期間對結果集所做的變更，AdomdDataReader 的使用者可能看得見。 不過，精確的行為視時間性而定。

當 AdomdDataReader 關閉之後，您將只能呼叫 IsClosed 和 RecordsAffected 屬性。

執行緒安全性

這個型別的任何公用 static (在 Visual Basic 中為 Shared) 成員都是執行緒安全的。並不是所有的執行個體成員都保證可以用於所有的執行緒。

請參閱

參考

Microsoft.AnalysisServices.AdomdServer 命名空間