OleDbDataReader Класс

Определение

Пространство имен:

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v11.0.0-preview.2.26159.112

Исходный код:

OleDbDataReader.cs

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

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataReader : System.Data.Common.DbDataReader

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataReader = class
    inherit DbDataReader

Public NotInheritable Class OleDbDataReader
Inherits DbDataReader

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

Object

DbDataReader

OleDbDataReader

Атрибуты

RequiresDynamicCodeAttribute

Примеры

В следующем примере создается 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

Комментарии

Чтобы создать OleDbDataReaderобъект, необходимо вызвать ExecuteReader метод OleDbCommand объекта, а не напрямую с помощью конструктора.

Перед закрытием OleDbConnectionOleDbDataReader объекта сначала закройте объект. Если планируется повторно использовать 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 Закрывает объект.
GetBoolean(Int32)	Возвращает значение указанного столбца как логическое значение.
GetByte(Int32)	Возвращает значение указанного столбца в виде байта.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Считывает поток байтов из указанного смещения столбца в буфер в виде массива, начиная с заданного смещения буфера.
GetChar(Int32)	Возвращает значение указанного столбца в виде символа.
GetChars(Int32, Int64, Char[], Int32, Int32)	Считывает поток символов из смещения указанного столбца в буфер в виде массива, начиная с заданного смещения буфера.
GetData(Int32)	OleDbDataReader Возвращает объект для запрошенного порядкового номера столбца.
GetDataTypeName(Int32)	Возвращает имя исходного типа данных.
GetDateTime(Int32)	Возвращает значение указанного столбца в качестве DateTime объекта.
GetDecimal(Int32)	Возвращает значение указанного столбца в качестве Decimal объекта.
GetDouble(Int32)	Возвращает значение указанного столбца в виде числа с плавающей запятой двойной точности.
GetEnumerator()	Возвращает значение IEnumerator , которое можно использовать для итерации строк в средстве чтения данных.
GetFieldType(Int32)	Type Возвращает тип данных объекта.
GetFloat(Int32)	Возвращает значение указанного столбца в виде числа с плавающей запятой с одной точностью.
GetGuid(Int32)	Возвращает значение указанного столбца в качестве глобально уникального идентификатора (GUID).
GetInt16(Int32)	Возвращает значение указанного столбца в виде 16-разрядного целого числа со знаком.
GetInt32(Int32)	Возвращает значение указанного столбца в виде 32-разрядного целого числа со знаком.
GetInt64(Int32)	Возвращает значение указанного столбца в виде 64-разрядного целого числа со знаком.
GetName(Int32)	Возвращает имя указанного столбца.
GetOrdinal(String)	Получает порядковый номер столбца с именем столбца.
GetSchemaTable()	Возвращает значение DataTable , описывающее метаданные столбца OleDbDataReader.
GetString(Int32)	Возвращает значение указанного столбца в виде строки.
GetTimeSpan(Int32)	Возвращает значение указанного столбца в качестве TimeSpan объекта.
GetValue(Int32)	Возвращает значение столбца в указанном порядковом номере в собственном формате.
GetValues(Object[])	Заполняет массив объектов значениями столбцов текущей строки.
IsDBNull(Int32)	Возвращает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.
NextResult()	Перемещает средство чтения данных к следующему результату при чтении результатов пакетных инструкций SQL.
Read()	Перемещает следующую OleDbDataReader запись.

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

• Объекты DataAdapter и DataReader