OleDbDataReader OleDbDataReader OleDbDataReader OleDbDataReader Class

Определение

Предоставляет способ чтения потока строк данных из источника только в прямом порядке.Provides a way of reading a forward-only stream of data rows from a data source. Этот класс не наследуется.This class cannot be inherited.

public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
type OleDbDataReader = class
    inherit DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Наследование

Примеры

В следующем примере создается OleDbConnection, OleDbCommandи OleDbDataReader.The following example creates an OleDbConnection, an OleDbCommand, and an OleDbDataReader. В примере считываются по данным, записывая их в консоль.The example reads through the data, writing it out to the console. Наконец, пример закрывает OleDbDataReader и затем OleDbConnection.Finally, the example closes the OleDbDataReader and then the 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 объекта вместо непосредственного использования конструктора.To create an OleDbDataReader, you must call the ExecuteReader method of the OleDbCommand object, instead of directly using a constructor.

Прежде чем закрыть OleDbConnection, сначала закройте OleDbDataReader объекта.Before you close the OleDbConnection, first close the OleDbDataReader object. Кроме того, необходимо закрыть OleDbDataReader объекта, если вы планируете resuse OleDbCommand объекта. Например, не удается получить выходные параметры можно только после вызова метода Close.You must also close the OleDbDataReader object if you plan to resuse an OleDbCommand object.For example, you cannot retrieve output parameters until after you call Close.

Изменения, внесенные в результирующий набор другим процессом или потоком во время чтения данных могут быть видны пользователю OleDbDataReader.Changes made to a result set by another process or thread while data is being read may be visible to the user of the OleDbDataReader. Однако точное поведение зависит от времени.However, the precise behavior is timing dependent.

IsClosed и RecordsAffected являются единственными свойствами, которые могут быть вызваны после OleDbDataReader закрыт.IsClosed and RecordsAffected are the only properties that you can call after the OleDbDataReader is closed. Несмотря на то что RecordsAffected свойству может осуществляться во время OleDbDataReader существует, всегда вызывать Close перед возвратом значения RecordsAffected гарантировать точность возвращаемого значения.Although the RecordsAffected property may be accessed while the OleDbDataReader exists, always call Close before returning the value of RecordsAffected to guarantee an accurate return value.

Свойства

Depth Depth Depth Depth

Возвращает значение, указывающее глубину вложенности для текущей строки.Gets a value that indicates 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

Получает значение, указывающее, содержит ли объект OleDbDataReader одну или несколько строк.Gets a value that indicates whether the OleDbDataReader contains one or more rows.

IsClosed IsClosed IsClosed IsClosed

Указывает, закрыто ли устройство считывания данных.Indicates whether the data reader is closed.

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

Возвращает значение указанного столбца в собственном формате при наличии заданного порядкового номера столбца.Gets the value of the specified column in its native format given the column ordinal.

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

Возвращает значение заданного столбца в собственном формате при наличии заданного имени столбца.Gets the value of the specified column in its native format given the column name.

RecordsAffected RecordsAffected RecordsAffected RecordsAffected

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

VisibleFieldCount VisibleFieldCount VisibleFieldCount VisibleFieldCount

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

Методы

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

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

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)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Позволяет объекту предпринять попытку освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора.Allows the object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

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)

Считывает поток байтов из заданного смещения столбца в буфер в виде массива, начиная с заданного смещения буфера.Reads a stream of bytes from the specified column offset into the buffer as an array starting at the given buffer offset.

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

Возвращает значение указанного столбца в виде символа.Gets the value of the specified column as a 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)

Считывает поток символов из заданного смещения столбца в буфер в виде массива, начиная с заданного смещения буфера.Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.

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

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

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

Получает имя исходного типа данных.Gets the name of the source data type.

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

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

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)

Возвращает тип Type, который является типом данных объекта.Gets the Type that is the data type of the object.

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 specified column.

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

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

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

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

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

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

GetTimeSpan(Int32) GetTimeSpan(Int32) GetTimeSpan(Int32) GetTimeSpan(Int32)

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

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

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

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

Получает значение столбца с указанным порядковом номером в собственном формате.Gets the value of the column at the specified ordinal in its native format.

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.

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()

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

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

Перемещает OleDbDataReader к следующей записи.Advances the OleDbDataReader to the next record.

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

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

(Inherited from Object)

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

IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32)

Возвращает IDataReader для указанного порядкового номера столбца.Returns an IDataReader for the specified column ordinal.

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

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

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Возвращает перечислитель, который осуществляет итерацию по коллекции.Returns an enumerator that iterates through a collection.

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

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