DbDataReader DbDataReader DbDataReader DbDataReader Class

Определение

Считывает однопроходные потоки строк из источника данных.Reads a forward-only stream of rows from a data source.

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

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

DbDataReader() DbDataReader() DbDataReader() DbDataReader()

Инициализирует новый экземпляр класса DbDataReader.Initializes a new instance of the DbDataReader class.

Свойства

Depth Depth Depth Depth

Возвращает значение, показывающее глубину вложенности для текущей строки.Gets a value indicating the depth of nesting for the current row.

FieldCount FieldCount FieldCount FieldCount

Возвращает число столбцов в текущей строке.Gets the number of columns in the current row.

HasRows HasRows HasRows HasRows

Возвращает значение, указывающее на то, что в модуле чтения данных DbDataReader содержится одна или несколько строк.Gets a value that indicates whether this DbDataReader contains one or more rows.

IsClosed IsClosed IsClosed IsClosed

Возвращает значение, указывающее, закрыт ли модуль чтения DbDataReader.Gets a value indicating whether the DbDataReader is closed.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Возвращает значение указанного столбца как экземпляр Object.Gets the value of the specified column as an instance of Object.

Item[String] Item[String] Item[String] Item[String]

Возвращает значение указанного столбца как экземпляр Object.Gets the value of the specified column as an instance of Object.

RecordsAffected RecordsAffected RecordsAffected RecordsAffected

Возвращает число строк, которые были изменены, вставлены или удалены инструкцией SQL.Gets the number of rows changed, inserted, or deleted by execution of the SQL statement.

VisibleFieldCount VisibleFieldCount VisibleFieldCount VisibleFieldCount

Возвращает число не скрытых полей в DbDataReader.Gets the number of fields in the DbDataReader that are not hidden.

Методы

Close() Close() Close() Close()

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

CloseAsync(CancellationToken) CloseAsync(CancellationToken) CloseAsync(CancellationToken) CloseAsync(CancellationToken)
CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader.Releases all resources used by the current instance of the DbDataReader class.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает управляемые ресурсы, используемые объектом DbDataReader (при необходимости освобождает и неуправляемые ресурсы).Releases the managed resources used by the DbDataReader and optionally releases the unmanaged resources.

DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32)

Возвращает значение указанного столбца в виде логического значения.Gets the value of the specified column as a Boolean.

GetByte(Int32) GetByte(Int32) GetByte(Int32) GetByte(Int32)

Возвращает значение указанного столбца в виде байта.Gets the value of the specified column as a byte.

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

Считывает поток байтов из указанного столбца, начиная с местоположения, указанного параметром dataOffset, в буфер, начиная с местоположения, указанного параметром bufferOffset.Reads a stream of bytes from the specified column, starting at location indicated by dataOffset, into the buffer, starting at the location indicated by bufferOffset.

GetChar(Int32) GetChar(Int32) GetChar(Int32) GetChar(Int32)

Возвращает значение указанного столбца в виде одного символа.Gets the value of the specified column as a single character.

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

Считывает поток символов из указанного столбца, начиная с местоположения, указанного параметром dataOffset, в буфер, начиная с местоположения, указанного параметром bufferOffset.Reads a stream of characters from the specified column, starting at location indicated by dataOffset, into the buffer, starting at the location indicated by bufferOffset.

GetData(Int32) GetData(Int32) GetData(Int32) GetData(Int32)

Возвращает объект DbDataReader для запрошенного порядкового номера столбца.Returns a DbDataReader object for the requested column ordinal.

GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32)

Возвращает имя типа данных заданного столбца.Gets name of the data type of the specified column.

GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32)

Возвращает значение указанного столбца в виде объекта DateTime.Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32) GetDbDataReader(Int32) GetDbDataReader(Int32) GetDbDataReader(Int32)

Возвращает объект DbDataReader для запрошенного порядкового номера столбца, который может быть переопределен с помощью зависящей от поставщика реализации.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32)

Возвращает значение указанного столбца в виде объекта Decimal.Gets the value of the specified column as a Decimal object.

GetDouble(Int32) GetDouble(Int32) GetDouble(Int32) GetDouble(Int32)

Возвращает значение заданного столбца в виде числа с плавающей запятой двойной точности.Gets the value of the specified column as a double-precision floating point number.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Возвращает перечислитель IEnumerator, который может использоваться для просмотра строк в модуле чтения данных.Returns an IEnumerator that can be used to iterate through the rows in the data reader.

GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32)

Возвращает тип данных заданного столбца.Gets the data type of the specified column.

GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32)

Синхронно получает значение заданного столбца в виде типа.Synchronously gets the value of the specified column as a type.

GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32)

Асинхронно получает значение заданного столбца в виде типа.Asynchronously gets the value of the specified column as a type.

GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken)

Асинхронно получает значение заданного столбца в виде типа.Asynchronously gets the value of the specified column as a type.

GetFloat(Int32) GetFloat(Int32) GetFloat(Int32) GetFloat(Int32)

Возвращает значение заданного столбца в виде числа с плавающей запятой одинарной точности.Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32) GetGuid(Int32) GetGuid(Int32) GetGuid(Int32)

Возвращает значение заданного столбца в виде глобально-уникального идентификатора GUID.Gets the value of the specified column as a globally-unique identifier (GUID).

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetInt16(Int32) GetInt16(Int32) GetInt16(Int32) GetInt16(Int32)

Получает значение заданного столбца в виде 16-битового целого числа со знаком.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32) GetInt32(Int32) GetInt32(Int32) GetInt32(Int32)

Возвращает значение указанного столбца в виде 32-разрядного целого числа со знаком.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32) GetInt64(Int32) GetInt64(Int32) GetInt64(Int32)

Возвращает значение указанного столбца в виде 64-разрядного целого числа со знаком.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetName(Int32) GetName(Int32) GetName(Int32) GetName(Int32)

Возвращает имя столбца, если известен его порядковый номер (от нуля).Gets the name of the column, given the zero-based column ordinal.

GetOrdinal(String) GetOrdinal(String) GetOrdinal(String) GetOrdinal(String)

Возвращает порядковый номер столбца, если известно его имя.Gets the column ordinal given the name of the column.

GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32)

Возвращает тип поля заданного столбца, зависящий от поставщика.Returns the provider-specific field type of the specified column.

GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32)

Возвращает значение указанного столбца как экземпляр Object.Gets the value of the specified column as an instance of Object.

GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[])

Возвращает из коллекции все столбцы атрибутов, зависящие от поставщика, для текущей строки.Gets all provider-specific attribute columns in the collection for the current row.

GetSchemaTable() GetSchemaTable() GetSchemaTable() GetSchemaTable()

Возвращает объект DataTable, описывающий метаданные столбцов модуля чтения данных DbDataReader.Returns a DataTable that describes the column metadata of the DbDataReader.

GetStream(Int32) GetStream(Int32) GetStream(Int32) GetStream(Int32)

Извлекает данные в виде Stream.Retrieves data as a Stream.

GetString(Int32) GetString(Int32) GetString(Int32) GetString(Int32)

Возвращает значение указанного столбца как экземпляр String.Gets the value of the specified column as an instance of String.

GetTextReader(Int32) GetTextReader(Int32) GetTextReader(Int32) GetTextReader(Int32)

Извлекает данные в виде TextReader.Retrieves data as a TextReader.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetValue(Int32) GetValue(Int32) GetValue(Int32) GetValue(Int32)

Возвращает значение указанного столбца как экземпляр Object.Gets the value of the specified column as an instance of Object.

GetValues(Object[]) GetValues(Object[]) GetValues(Object[]) GetValues(Object[])

Заполняет массив объектов значениями столбцов текущей строки.Populates an array of objects with the column values of the current row.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32)

Возвращает значение, указывающее, содержатся ли в столбце несуществующие или отсутствующие значения.Gets a value that indicates whether the column contains nonexistent or missing values.

IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32)

Асинхронная версия метода IsDBNull(Int32), который получает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken)

Асинхронная версия метода IsDBNull(Int32), который получает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values. При необходимости отправляет уведомление о том, что операции следует отменить.Optionally, sends a notification that operations should be cancelled.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
NextResult() NextResult() NextResult() NextResult()

Перемещает модуль чтения данных к следующему результату при чтении результатов из пакета инструкций.Advances the reader to the next result when reading the results of a batch of statements.

NextResultAsync() NextResultAsync() NextResultAsync() NextResultAsync()

Асинхронная версия метода NextResult(), который перемещает средство чтения к следующему результату при чтении результатов из пакета инструкций.An asynchronous version of NextResult(), which advances the reader to the next result when reading the results of a batch of statements.

Вызывает NextResultAsync(CancellationToken) с CancellationToken.None.Invokes NextResultAsync(CancellationToken) with CancellationToken.None.

NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken)

Это асинхронная версия метода NextResult().This is the asynchronous version of NextResult(). Поставщики должны выполнить переопределение с помощью соответствующей реализации.Providers should override with an appropriate implementation. При необходимости можно игнорировать cancellationToken.The cancellationToken may optionally be ignored.

Реализация по умолчанию вызывает синхронный метод NextResult() и возвращает завершенную задачу, блокируя вызывающий поток.The default implementation invokes the synchronous NextResult() method and returns a completed task, blocking the calling thread. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный cancellationToken.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Исключения, создаваемые NextResult(), будут связаны через возвращаемое свойство исключения задачи.Exceptions thrown by NextResult() will be communicated via the returned Task Exception property.

Другие методы и свойства объекта DbDataReader не должны вызываться, когда возвращаемая задача еще не завершена.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

Read() Read() Read() Read()

Перемещает модуль чтения к следующей записи в результирующем наборе.Advances the reader to the next record in a result set.

ReadAsync() ReadAsync() ReadAsync() ReadAsync()

Асинхронная версия Read(), которая перемещает модуль чтения к следующей записи в наборе результатов.An asynchronous version of Read(), which advances the reader to the next record in a result set. Этот метод вызывает метод ReadAsync(CancellationToken) с CancellationToken.None.This method invokes ReadAsync(CancellationToken) with CancellationToken.None.

ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken)

Это асинхронная версия метода Read().This is the asynchronous version of Read(). Поставщики должны выполнить переопределение с помощью соответствующей реализации.Providers should override with an appropriate implementation. При необходимости можно игнорировать cancellationToken.The cancellationToken may optionally be ignored.

Реализация по умолчанию вызывает синхронный метод Read() и возвращает завершенную задачу, блокируя вызывающий поток.The default implementation invokes the synchronous Read() method and returns a completed task, blocking the calling thread. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный cancellationToken.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Исключения, создаваемые Read, будут связаны через возвращаемое свойство исключения задачи.Exceptions thrown by Read will be communicated via the returned Task Exception property.

Не вызывайте другие методы и свойства объекта DbDataReader до тех пор, пока возвращаемая задача не будет завершена.Do not invoke other methods and properties of the DbDataReader object until the returned Task is complete.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

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

IDataReader.Close() IDataReader.Close() IDataReader.Close() IDataReader.Close()
IDataReader.GetSchemaTable() IDataReader.GetSchemaTable() IDataReader.GetSchemaTable() IDataReader.GetSchemaTable()
IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32)

Описание этого члена см. в разделе GetData(Int32).For a description of this member, see GetData(Int32).

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

CanGetColumnSchema(DbDataReader) CanGetColumnSchema(DbDataReader) CanGetColumnSchema(DbDataReader) CanGetColumnSchema(DbDataReader)

Получает значение, которое указывает, может ли DbDataReader получить схему столбца.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader) GetColumnSchema(DbDataReader) GetColumnSchema(DbDataReader) GetColumnSchema(DbDataReader)

Получает схему столбца (коллекцию DbColumn) для DbDataReader.Gets the column schema (DbColumn collection) for a DbDataReader.

GetBoolean(DbDataReader, String) GetBoolean(DbDataReader, String) GetBoolean(DbDataReader, String) GetBoolean(DbDataReader, String)
GetByte(DbDataReader, String) GetByte(DbDataReader, String) GetByte(DbDataReader, String) GetByte(DbDataReader, String)
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32) GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32) GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32) GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)
GetChar(DbDataReader, String) GetChar(DbDataReader, String) GetChar(DbDataReader, String) GetChar(DbDataReader, String)
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32) GetChars(DbDataReader, String, Int64, Char[], Int32, Int32) GetChars(DbDataReader, String, Int64, Char[], Int32, Int32) GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)
GetData(DbDataReader, String) GetData(DbDataReader, String) GetData(DbDataReader, String) GetData(DbDataReader, String)
GetDataTypeName(DbDataReader, String) GetDataTypeName(DbDataReader, String) GetDataTypeName(DbDataReader, String) GetDataTypeName(DbDataReader, String)
GetDateTime(DbDataReader, String) GetDateTime(DbDataReader, String) GetDateTime(DbDataReader, String) GetDateTime(DbDataReader, String)
GetDecimal(DbDataReader, String) GetDecimal(DbDataReader, String) GetDecimal(DbDataReader, String) GetDecimal(DbDataReader, String)
GetDouble(DbDataReader, String) GetDouble(DbDataReader, String) GetDouble(DbDataReader, String) GetDouble(DbDataReader, String)
GetFieldType(DbDataReader, String) GetFieldType(DbDataReader, String) GetFieldType(DbDataReader, String) GetFieldType(DbDataReader, String)
GetFieldValue<T>(DbDataReader, String) GetFieldValue<T>(DbDataReader, String) GetFieldValue<T>(DbDataReader, String) GetFieldValue<T>(DbDataReader, String)
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken) GetFieldValueAsync<T>(DbDataReader, String, CancellationToken) GetFieldValueAsync<T>(DbDataReader, String, CancellationToken) GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)
GetFloat(DbDataReader, String) GetFloat(DbDataReader, String) GetFloat(DbDataReader, String) GetFloat(DbDataReader, String)
GetGuid(DbDataReader, String) GetGuid(DbDataReader, String) GetGuid(DbDataReader, String) GetGuid(DbDataReader, String)
GetInt16(DbDataReader, String) GetInt16(DbDataReader, String) GetInt16(DbDataReader, String) GetInt16(DbDataReader, String)
GetInt32(DbDataReader, String) GetInt32(DbDataReader, String) GetInt32(DbDataReader, String) GetInt32(DbDataReader, String)
GetInt64(DbDataReader, String) GetInt64(DbDataReader, String) GetInt64(DbDataReader, String) GetInt64(DbDataReader, String)
GetProviderSpecificFieldType(DbDataReader, String) GetProviderSpecificFieldType(DbDataReader, String) GetProviderSpecificFieldType(DbDataReader, String) GetProviderSpecificFieldType(DbDataReader, String)
GetProviderSpecificValue(DbDataReader, String) GetProviderSpecificValue(DbDataReader, String) GetProviderSpecificValue(DbDataReader, String) GetProviderSpecificValue(DbDataReader, String)
GetStream(DbDataReader, String) GetStream(DbDataReader, String) GetStream(DbDataReader, String) GetStream(DbDataReader, String)
GetString(DbDataReader, String) GetString(DbDataReader, String) GetString(DbDataReader, String) GetString(DbDataReader, String)
GetTextReader(DbDataReader, String) GetTextReader(DbDataReader, String) GetTextReader(DbDataReader, String) GetTextReader(DbDataReader, String)
GetValue(DbDataReader, String) GetValue(DbDataReader, String) GetValue(DbDataReader, String) GetValue(DbDataReader, String)
IsDBNull(DbDataReader, String) IsDBNull(DbDataReader, String) IsDBNull(DbDataReader, String) IsDBNull(DbDataReader, String)
IsDBNullAsync(DbDataReader, String, CancellationToken) IsDBNullAsync(DbDataReader, String, CancellationToken) IsDBNullAsync(DbDataReader, String, CancellationToken) IsDBNullAsync(DbDataReader, String, CancellationToken)
Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Преобразует IEnumerable для IQueryable.Converts an IEnumerable to an IQueryable.

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

Дополнительно