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	返回一个字符串，该字符串包含指定列的数据类型的全名。
	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	返回包含来自指定列的值的一个字符串。
	GetTimeSpan	获取包含来自指定列的值的 TimeSpan。
	GetType	（从 Object 继承。）
	GetValue	返回以本机格式表示的指定列的值。
	GetValues	获取当前行中所有列的值的数组。
	InitializeLifetimeService	安全关键。 （从 MarshalByRefObject 继承。）
	IsDBNull	返回一个布尔值，该值包含指示列是否设置为 Null 的值。
	NextResult	此成员留待将来使用。
	Read	将 AdomdDataReader 前移到下一行。
	ToString	（从 Object 继承。）

顶部

注释

AdomdDataReader 类是 ADOMD.NET 的 [System.Data.IDataReader] 接口的实现。 所有 Microsoft .NET 数据访问接口均实现 [System.Data.IDataReader] 接口以快速读取只进结果集。

要创建 AdomdDataReader，您必须调用 AdomdCommand 的 ExecuteReader 方法而非直接使用构造函数。

尽管 AdomdDataReader 在使用中，AdomdCommand 和相关的 AdomdConnection 仍忙于为 AdomdDataReader 服务。 在此状态下，除了关闭 AdomdConnection 或 AdomdCommand 对象之外无法对它们执行任何其他操作。 在调用 AdomdDataReader 的 Close 或 Dispose 方法之前，这种情况一直持续。 正在读取数据时另一进程或线程对结果集所做的更改可能对 AdomdDataReader 的用户可见。 但是，确切的行为与时间有关。

IsClosed 和 RecordsAffected 是在关闭 AdomdDataReader 后您可以调用的唯一属性。

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。不保证所有实例成员都是线程安全的。

请参阅

参考

Microsoft.AnalysisServices.AdomdServer 命名空间