OleDbDataReader Класс

Ссылка

Определение

Пространство имен:: System.Data.OleDb

Сборка:: System.Data.OleDb.dll

Сборка:: System.Data.dll

Пакет:: System.Data.OleDb v8.0.0

Пакет:: System.Data.OleDb v9.0.0-preview.7.24405.7

Исходный код:: OleDbDataReader.cs

Исходный код:: OleDbDataReader.cs

Исходный код:: OleDbDataReader.cs

Исходный код:: OleDbDataReader.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader

public ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader

public sealed class OleDbDataReader : System.Data.Common.DbDataReader

public sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader

type OleDbDataReader = class
    inherit DbDataReader

type OleDbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDisposable
    interface IDataRecord
    interface IEnumerable

Public NotInheritable Class OleDbDataReader
Inherits DbDataReader

Public NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable

Наследование: Object

MarshalByRefObject

DbDataReader
OleDbDataReader

Наследование: Object

MarshalByRefObject
OleDbDataReader

Реализации: IEnumerable IDataReader IDataRecord IDisposable

Примеры

В следующем примере создается OleDbConnection, OleDbCommandи OleDbDataReader. Пример считывает данные, записывая его в консоль. Наконец, в примере закрывается OleDbDataReader, а затем OleDbConnection.

public static void ReadData(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);

        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}

Public Sub ReadData(ByVal connectionString As String, _
    ByVal queryString As String)
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

Перед закрытием OleDbConnectionсначала закройте объект OleDbDataReader. Если планируется повторно использовать объект OleDbCommand, необходимо также закрыть объект OleDbDataReader. Например, вы не сможете получить выходные параметры до тех пор, пока не вызовете Close.

Изменения, внесенные в результирующий набор другим процессом или потоком во время чтения данных, могут отображаться пользователю OleDbDataReader. Однако точное поведение зависит от времени.

IsClosed и RecordsAffected являются единственными свойствами, которые можно вызывать после закрытия OleDbDataReader. Хотя к свойству RecordsAffected можно получить доступ во время существования OleDbDataReader, всегда вызывать Close перед возвратом значения RecordsAffected, чтобы гарантировать точное возвращаемое значение.

Свойства

Depth	Возвращает значение, указывающее глубину вложения текущей строки.
FieldCount	Возвращает количество столбцов в текущей строке.
HasRows	Возвращает значение, указывающее, содержит ли OleDbDataReader одну или несколько строк.
IsClosed	Указывает, закрыт ли модуль чтения данных.
Item[Int32]	Возвращает значение указанного столбца в собственном формате, учитывая порядковый номер столбца.
Item[String]	Возвращает значение указанного столбца в собственном формате с именем столбца.
RecordsAffected	Возвращает количество строк, измененных, вставленных или удаленных при выполнении инструкции SQL.
VisibleFieldCount	Возвращает количество полей в OleDbDataReader, которые не скрыты.

Методы

Close()	Закрывает объект OleDbDataReader.
CloseAsync()	Асинхронно закрывает объект DbDataReader. (Унаследовано от DbDataReader)
CreateObjRef(Type)	Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader. (Унаследовано от DbDataReader)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые DbDataReader, и при необходимости освобождает управляемые ресурсы. (Унаследовано от DbDataReader)
DisposeAsync()	Асинхронно освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader. (Унаследовано от DbDataReader)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Finalize()	Позволяет объекту пытаться освободить ресурсы и выполнять другие операции очистки перед его восстановлением сборкой мусора.
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), будут передаваться через возвращаемое свойство "Исключение задачи". (Унаследовано от DbDataReader)
GetData(Int32)	Возвращает объект OleDbDataReader для запрошенного порядкового столбца.
GetDataTypeName(Int32)	Возвращает имя исходного типа данных.
GetDateTime(Int32)	Возвращает значение указанного столбца в качестве объекта DateTime.
GetDbDataReader(Int32)	Возвращает объект DbDataReader для запрошенного порядкового номера столбца, который можно переопределить с помощью реализации для конкретного поставщика. (Унаследовано от DbDataReader)
GetDecimal(Int32)	Возвращает значение указанного столбца в качестве объекта Decimal.
GetDouble(Int32)	Возвращает значение указанного столбца в виде числа с плавающей запятой двойной точности.
GetEnumerator()	Возвращает IEnumerator, который можно использовать для итерации строк в средстве чтения данных.
GetFieldType(Int32)	Возвращает Type, который является типом данных объекта.
GetFieldValue<T>(Int32)	Возвращает значение указанного столбца в качестве запрошенного типа. (Унаследовано от DbDataReader)
GetFieldValueAsync<T>(Int32)	Асинхронно получает значение указанного столбца в качестве запрошенного типа. (Унаследовано от DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Асинхронно получает значение указанного столбца в качестве запрошенного типа. (Унаследовано от DbDataReader)
GetFloat(Int32)	Возвращает значение указанного столбца в виде числа с плавающей запятой с одной точностью.
GetGuid(Int32)	Возвращает значение указанного столбца в качестве глобально уникального идентификатора (GUID).
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetInt16(Int32)	Возвращает значение указанного столбца в виде 16-разрядного целого числа со знаком.
GetInt32(Int32)	Возвращает значение указанного столбца в виде 32-разрядного целого числа со знаком.
GetInt64(Int32)	Возвращает значение указанного столбца в виде 64-разрядного целого числа со знаком.
GetLifetimeService()	Устаревшие.. Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
GetName(Int32)	Возвращает имя указанного столбца.
GetOrdinal(String)	Получает порядковый номер столбца с именем столбца.
GetProviderSpecificFieldType(Int32)	Возвращает тип конкретного поставщика указанного столбца. (Унаследовано от DbDataReader)
GetProviderSpecificValue(Int32)	Возвращает значение указанного столбца в качестве экземпляра конкретного типа поставщика. (Унаследовано от DbDataReader)
GetProviderSpecificValues(Object[])	Возвращает все столбцы атрибутов для конкретного поставщика в коллекции для текущей строки. (Унаследовано от DbDataReader)
GetSchemaTable()	Возвращает DataTable, описывающий метаданные столбца OleDbDataReader.
GetSchemaTableAsync(CancellationToken)	Это асинхронная версия GetSchemaTable(). Поставщики должны переопределить соответствующую реализацию. `cancellationToken` можно при необходимости учитывать. Реализация по умолчанию вызывает синхронный вызов GetSchemaTable() и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененной `cancellationToken`. Исключения, создаваемые GetSchemaTable(), будут передаваться через возвращаемое свойство "Исключение задачи". (Унаследовано от DbDataReader)
GetStream(Int32)	Получает поток для получения данных из указанного столбца. (Унаследовано от DbDataReader)
GetString(Int32)	Возвращает значение указанного столбца в виде строки.
GetTextReader(Int32)	Получает средство чтения текста для получения данных из столбца. (Унаследовано от DbDataReader)
GetTimeSpan(Int32)	Возвращает значение указанного столбца в качестве объекта TimeSpan.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetValue(Int32)	Возвращает значение столбца в указанном порядковом номере в собственном формате.
GetValues(Object[])	Заполняет массив объектов значениями столбцов текущей строки.
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
IsDBNull(Int32)	Возвращает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.
IsDBNullAsync(Int32)	Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения. (Унаследовано от DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения. (Унаследовано от DbDataReader)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неглубокую копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
NextResult()	Перемещает средство чтения данных к следующему результату при чтении результатов пакетных инструкций SQL.
NextResultAsync()	Асинхронно перемещает средство чтения к следующему результату при чтении результатов пакета инструкций. (Унаследовано от DbDataReader)
NextResultAsync(CancellationToken)	Асинхронно перемещает средство чтения к следующему результату при чтении результатов пакета инструкций. (Унаследовано от DbDataReader)
Read()	Перемещает OleDbDataReader к следующей записи.
ReadAsync()	Асинхронно перемещает средство чтения к следующей записи в результирующем наборе. (Унаследовано от DbDataReader)
ReadAsync(CancellationToken)	Асинхронно перемещает средство чтения к следующей записи в результирующем наборе. (Унаследовано от DbDataReader)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

IDataRecord.GetData(Int32)	Возвращает IDataReader для указанного порядкового номера столбца.
IDataRecord.GetData(Int32)	Описание этого элемента см. в разделе GetData(Int32). (Унаследовано от DbDataReader)
IDisposable.Dispose()	Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода. Освобождает ресурсы, используемые текущим экземпляром класса OleDbDataReader.
IEnumerable.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по коллекции.

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

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)	Настраивает способ ожидания задач, возвращаемых из асинхронного удаления.

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

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

DataAdapters и DataReaders

Бөлісу құралы: