Класс 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 вместо непосредственного использования конструктора необходимо вызвать метод ExecuteReader объекта AdomdCommand.

Во время использования AdomdDataReader объект AdomdCommand и связанный с ним объект AdomdDataReader занимаются обслуживанием AdomdConnection. В этом состоянии никакие операции, кроме закрытия, с объектом AdomdConnection или AdomdCommand выполнять нельзя. Такое состояние сохраняется до тех пор, пока не будет вызван метод Close или Dispose модуля AdomdDataReader. Изменения, внесенные в результирующий набор другим процессом или потоком во время выполнения чтения данных, могут быть видны пользователю AdomdDataReader. Однако точное поведение зависит от времени.

Свойства IsClosed и RecordsAffected являются единственными, которые можно вызывать после закрытия AdomdDataReader.

Безопасность многопоточности

Любые открытые статический (Shared в Visual Basic) элементы этого типа потокобезопасны. Потокобезопасность с элементами экземпляров не гарантируется.

См. также

Справочник

Пространство имен Microsoft.AnalysisServices.AdomdServer