AdomdDataReader Class

Article
12/03/2008

Provides a means of reading a forward-only result set obtained by running a command, and can be used to access multidimensional data sources.

Namespace: Microsoft.AnalysisServices.AdomdServer
Assembly: msmgdsrv (in msmgdsrv.dll)

Syntax

'Declaration
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
<DefaultMemberAttribute("Item")> _
Public NotInheritable Class AdomdDataReader
    Inherits MarshalByRefObject
    Implements IDataReader, IDisposable, IDataRecord, IEnumerable

[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")] 
[DefaultMemberAttribute("Item")] 
public sealed class AdomdDataReader : MarshalByRefObject, IDataReader, IDisposable, IDataRecord, 
    IEnumerable

[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")] 
[DefaultMemberAttribute(L"Item")] 
public ref class AdomdDataReader sealed : public MarshalByRefObject, IDataReader, IDisposable, IDataRecord, 
    IEnumerable

/** @attribute SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix") */ 
/** @attribute DefaultMemberAttribute("Item") */ 
public final class AdomdDataReader extends MarshalByRefObject implements IDataReader, IDisposable, 
    IDataRecord, IEnumerable

SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix") 
DefaultMemberAttribute("Item") 
public final class AdomdDataReader extends MarshalByRefObject implements IDataReader, IDisposable, 
    IDataRecord, IEnumerable

Remarks

The AdomdDataReader class is the implementation of the System.Data.IDataReader interface for ADOMD.NET. All Microsoft .NET data providers implement the System.Data.IDataReader interface as a way of quickly reading forward-only result sets.

To create a AdomdDataReader, you must call the ExecuteReader method of the AdomdCommand, rather than directly using a constructor.

While the AdomdDataReader is in use, the AdomdCommand and the associated AdomdConnection is busy serving the AdomdDataReader. While in this state, no operations can be performed on the AdomdConnection or AdomdCommand objects other than closing them. This remains the case until the Close or Dispose method of the AdomdDataReader is called. Changes made to a result set by another process or thread while data is being read may be visible to the user of the AdomdDataReader. However, the precise behavior is timing dependent.

IsClosed and RecordsAffected are the only properties that you can call after the AdomdDataReader is closed.

Inheritance Hierarchy

System.Object
System.MarshalByRefObject
Microsoft.AnalysisServices.AdomdServer.AdomdDataReader

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms