Поделиться через


DbDataReader Класс

Определение

Считывает поток строк, доступных только для пересылки, из источника данных.

public ref class DbDataReader abstract : IDisposable, System::Collections::IEnumerable
public ref class DbDataReader abstract : MarshalByRefObject, IAsyncDisposable, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : MarshalByRefObject, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : MarshalByRefObject, IAsyncDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public abstract class DbDataReader : IDisposable, System.Collections.IEnumerable
public abstract class DbDataReader : MarshalByRefObject, IAsyncDisposable, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : MarshalByRefObject, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : MarshalByRefObject, IAsyncDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type DbDataReader = class
    interface IEnumerable
    interface IDisposable
type DbDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IAsyncDisposable
type DbDataReader = class
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
type DbDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
type DbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDisposable
    interface IDataRecord
    interface IEnumerable
Public MustInherit Class DbDataReader
Implements IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDataReader, IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Implements IDataReader, IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDataReader, IEnumerable
Наследование
DbDataReader
Наследование
DbDataReader
Производный
Реализации

Конструкторы

DbDataReader()

Инициализирует новый экземпляр класса DbDataReader.

Свойства

Depth

Возвращает значение, указывающее глубину вложения текущей строки.

FieldCount

При переопределении в производном классе получает количество столбцов в текущей строке.

HasRows

При переопределении в производном классе получает значение, указывающее, содержит ли этот DbDataReader одну или несколько строк.

IsClosed

При переопределении в производном классе получает значение, указывающее, закрыт ли DbDataReader.

Item[Int32]

При переопределении в производном классе получает значение указанного столбца в качестве экземпляра Object.

Item[String]

При переопределении в производном классе получает значение указанного столбца в качестве экземпляра Object.

RecordsAffected

При переопределении в производном классе получает количество строк, измененных, вставленных или удаленных путем выполнения инструкции SQL.

VisibleFieldCount

Возвращает количество полей в DbDataReader, которые не скрыты.

Методы

Close()

Закрывает объект DbDataReader.

CloseAsync()

Асинхронно закрывает объект DbDataReader.

CreateObjRef(Type)

Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader.

Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые DbDataReader, и при необходимости освобождает управляемые ресурсы.

DisposeAsync()

Асинхронно освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetBoolean(Int32)

При переопределении в производном классе получает значение указанного столбца как логическое значение.

GetByte(Int32)

При переопределении в производном классе получает значение указанного столбца в виде байта.

GetBytes(Int32, Int64, Byte[], Int32, Int32)

При переопределении в производном классе считывает указанное число байтов из указанного столбца, начиная с указанного индекса, и записывает их в буфер, начиная с указанной позиции в буфере.

GetChar(Int32)

При переопределении в производном классе получает значение указанного столбца в виде одного символа.

GetChars(Int32, Int64, Char[], Int32, Int32)

При переопределении в производном классе считывает указанное число символов из указанного столбца, начиная с указанного индекса, и записывает их в буфер, начиная с указанной позиции.

GetColumnSchemaAsync(CancellationToken)

Это асинхронная версия GetColumnSchema(DbDataReader). Поставщики должны переопределить соответствующую реализацию. cancellationToken можно при необходимости учитывать. Реализация по умолчанию вызывает синхронный вызов GetColumnSchema(DbDataReader) и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененной cancellationToken. Исключения, создаваемые GetColumnSchema(DbDataReader), будут передаваться через возвращаемое свойство "Исключение задачи".

GetData(Int32)

Возвращает вложенное средство чтения данных для запрошенного столбца.

GetDataTypeName(Int32)

При переопределении в производном классе получает имя типа данных указанного столбца.

GetDateTime(Int32)

При переопределении в производном классе получает значение указанного столбца в качестве объекта DateTime.

GetDbDataReader(Int32)

Возвращает объект DbDataReader для запрошенного порядкового номера столбца, который можно переопределить с помощью реализации для конкретного поставщика.

GetDecimal(Int32)

При переопределении в производном классе получает значение указанного столбца в виде Decimal.

GetDouble(Int32)

При переопределении в производном классе получает значение указанного столбца в виде числа с плавающей запятой двойной точности.

GetEnumerator()

При переопределении в производном классе возвращает перечислитель, который можно использовать для итерации строк в средстве чтения данных.

GetFieldType(Int32)

При переопределении в производном классе получает тип данных указанного столбца.

GetFieldValue<T>(Int32)

Возвращает значение указанного столбца в качестве запрошенного типа.

GetFieldValueAsync<T>(Int32)

Асинхронно получает значение указанного столбца в качестве запрошенного типа.

GetFieldValueAsync<T>(Int32, CancellationToken)

Асинхронно получает значение указанного столбца в качестве запрошенного типа.

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)

Возвращает значение указанного столбца в качестве экземпляра конкретного типа поставщика.

GetProviderSpecificValues(Object[])

Возвращает все столбцы атрибутов для конкретного поставщика в коллекции для текущей строки.

GetSchemaTable()

Возвращает DataTable, описывающий метаданные столбца DbDataReader. Возвращает null, если выполненная команда не вернула набор результатов или после NextResult() возвращает false.

GetSchemaTableAsync(CancellationToken)

Это асинхронная версия GetSchemaTable(). Поставщики должны переопределить соответствующую реализацию. cancellationToken можно при необходимости учитывать. Реализация по умолчанию вызывает синхронный вызов GetSchemaTable() и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененной cancellationToken. Исключения, создаваемые GetSchemaTable(), будут передаваться через возвращаемое свойство "Исключение задачи".

GetStream(Int32)

Получает поток для получения данных из указанного столбца.

GetString(Int32)

При переопределении в производном классе получает значение указанного столбца в качестве экземпляра String.

GetTextReader(Int32)

Получает средство чтения текста для получения данных из столбца.

GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
GetValue(Int32)

При переопределении в производном классе получает значение указанного столбца в качестве экземпляра Object.

GetValues(Object[])

При переопределении в производном классе заполняет массив объектов значениями столбцов текущей строки.

InitializeLifetimeService()
Устаревшие..

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.

(Унаследовано от MarshalByRefObject)
IsDBNull(Int32)

При переопределении в производном классе получает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.

IsDBNullAsync(Int32)

Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения.

IsDBNullAsync(Int32, CancellationToken)

Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения.

MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неглубокую копию текущего объекта MarshalByRefObject.

(Унаследовано от MarshalByRefObject)
NextResult()

При переопределении в производном классе перемещает читателя к следующему результату при чтении результатов пакета инструкций.

NextResultAsync()

Асинхронно перемещает средство чтения к следующему результату при чтении результатов пакета инструкций.

NextResultAsync(CancellationToken)

Асинхронно перемещает средство чтения к следующему результату при чтении результатов пакета инструкций.

Read()

При переопределении в производном классе читатель переходит к следующей записи в результирующем наборе.

ReadAsync()

Асинхронно перемещает средство чтения к следующей записи в результирующем наборе.

ReadAsync(CancellationToken)

Асинхронно перемещает средство чтения к следующей записи в результирующем наборе.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Явные реализации интерфейса

IDataReader.Close()

Описание этого элемента см. в разделе Close().

IDataReader.GetSchemaTable()

Описание этого элемента см. в разделе GetSchemaTable().

IDataRecord.GetData(Int32)

Описание этого элемента см. в разделе GetData(Int32).

Методы расширения

CanGetColumnSchema(DbDataReader)

Возвращает значение, указывающее, может ли DbDataReader получить схему столбца.

GetColumnSchema(DbDataReader)

Получает схему столбцов (коллекциюDbColumn) для DbDataReader.

GetBoolean(DbDataReader, String)

Возвращает значение указанного столбца как логическое значение.

GetByte(DbDataReader, String)

Возвращает значение указанного столбца в виде байта.

GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)

Считывает указанное число байтов из указанного столбца, начиная с указанного индекса, и записывает их в буфер, начиная с указанной позиции в буфере.

GetChar(DbDataReader, String)

Возвращает значение указанного столбца в виде одного символа.

GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)

Считывает указанное число символов из указанного столбца, начиная с указанного индекса, и записывает их в буфер, начиная с указанной позиции.

GetData(DbDataReader, String)

Возвращает вложенное средство чтения данных для запрошенного столбца.

GetDataTypeName(DbDataReader, String)

Возвращает имя типа данных указанного столбца.

GetDateTime(DbDataReader, String)

Возвращает значение указанного столбца в качестве объекта DateTime.

GetDecimal(DbDataReader, String)

Возвращает значение указанного столбца в виде Decimal.

GetDouble(DbDataReader, String)

Возвращает значение указанного столбца в виде числа с плавающей запятой двойной точности.

GetFieldType(DbDataReader, String)

Возвращает тип данных указанного столбца.

GetFieldValue<T>(DbDataReader, String)

Возвращает значение указанного столбца в качестве запрошенного типа.

GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)

Асинхронно получает значение указанного столбца в качестве запрошенного типа.

GetFloat(DbDataReader, String)

Возвращает значение указанного столбца в виде числа с плавающей запятой с одной точностью.

GetGuid(DbDataReader, String)

Возвращает значение указанного столбца в качестве глобально уникального идентификатора (GUID).

GetInt16(DbDataReader, String)

Возвращает значение указанного столбца в виде 16-разрядного целого числа со знаком.

GetInt32(DbDataReader, String)

Возвращает значение указанного столбца в виде 32-разрядного целого числа со знаком.

GetInt64(DbDataReader, String)

Возвращает значение указанного столбца в виде 64-разрядного целого числа со знаком.

GetProviderSpecificFieldType(DbDataReader, String)

Возвращает тип конкретного поставщика указанного столбца.

GetProviderSpecificValue(DbDataReader, String)

Возвращает значение указанного столбца в качестве экземпляра конкретного типа поставщика.

GetStream(DbDataReader, String)

Получает поток для получения данных из указанного столбца.

GetString(DbDataReader, String)

Возвращает значение указанного столбца в качестве экземпляра String.

GetTextReader(DbDataReader, String)

Получает средство чтения текста для получения данных из столбца.

GetValue(DbDataReader, String)

Возвращает значение указанного столбца в качестве экземпляра Object.

IsDBNull(DbDataReader, String)

Возвращает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.

IsDBNullAsync(DbDataReader, String, CancellationToken)

Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения.

Cast<TResult>(IEnumerable)

Приведение элементов IEnumerable к указанному типу.

OfType<TResult>(IEnumerable)

Фильтрует элементы IEnumerable на основе указанного типа.

AsParallel(IEnumerable)

Включает параллелизацию запроса.

AsQueryable(IEnumerable)

Преобразует IEnumerable в IQueryable.

ConfigureAwait(IAsyncDisposable, Boolean)

Настраивает способ ожидания задач, возвращаемых из асинхронного удаления.

Применяется к

См. также раздел

  • dbProviderFactories (ADO.NET)
  • обзора ADO.NET