OdbcDataReader Класс

Определение

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

System.Data.Odbc

Сборка:

System.Data.Odbc.dll

Пакет:

System.Data.Odbc v8.0.0

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

OdbcDataReader.cs

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

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

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

type OdbcDataReader = class
    inherit DbDataReader

Public NotInheritable Class OdbcDataReader
Inherits DbDataReader

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

Object

DbDataReader

OdbcDataReader

Примеры

В следующем примере создаются OdbcConnection, и OdbcCommandOdbcDataReader. Пример считывает данные, записывая их в консоль. Наконец, пример закрывает OdbcDataReader, а затем OdbcConnection.

public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand(queryString, connection);

        connection.Open();

        // Execute the DataReader and access the data.
        OdbcDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader[0]);
        }

        // Call Close when done reading.
        reader.Close();
    }
}

Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"

    Using connection As New OdbcConnection(connectionString)
        Dim command As New OdbcCommand(queryString, connection)

        connection.Open()

        Dim reader As OdbcDataReader = command.ExecuteReader()

        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader(0).ToString)
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

Комментарии

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

OdbcDataReader Пока используется , связанный OdbcConnection объект занят обслуживанием OdbcDataReader, и другие операции не могут выполняться с OdbcConnection , кроме закрытия. Это происходит до тех пор, Close пока не будет вызван метод объекта OdbcDataReader . Например, вы не сможете получить выходные параметры до тех пор, пока не вызовете Close.

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

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

Свойства

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

Методы

Close()	Закрывает объект OdbcDataReader.
CloseAsync()	Асинхронно закрывает объект DbDataReader. (Унаследовано от DbDataReader)
Dispose()	Освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader. (Унаследовано от DbDataReader)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом DbDataReader, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от DbDataReader)
DisposeAsync()	Асинхронно освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader. (Унаследовано от 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), будут связаны через возвращаемое свойство исключения задачи. (Унаследовано от DbDataReader)
GetData(Int32)	Возвращает вложенный объект чтения данных для запрошенного столбца. (Унаследовано от DbDataReader)
GetDataTypeName(Int32)	Получает имя исходного типа данных.
GetDate(Int32)	Возвращает значение указанного столбца в виде объекта DateTime.
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-разрядного целого числа со знаком.
GetName(Int32)	Возвращает имя заданного столбца.
GetOrdinal(String)	Возвращает порядковый номер столбца при наличии заданного имени столбца.
GetProviderSpecificFieldType(Int32)	Возвращает тип заданного столбца, зависящий от поставщика. (Унаследовано от DbDataReader)
GetProviderSpecificValue(Int32)	Возвращает значение указанного столбца как экземпляр зависящего от поставщика типа. (Унаследовано от DbDataReader)
GetProviderSpecificValues(Object[])	Возвращает из коллекции все столбцы атрибутов, зависящие от поставщика, для текущей строки. (Унаследовано от DbDataReader)
GetSchemaTable()	Возвращает объект DataTable, описывающий метаданные столбцов модуля чтения данных OdbcDataReader.
GetSchemaTableAsync(CancellationToken)	Это асинхронная версия метода GetSchemaTable(). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать cancellationToken. Реализация по умолчанию вызывает синхронный метод GetSchemaTable() и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный cancellationToken. Исключения, создаваемые GetSchemaTable(), будут связаны через возвращаемое свойство исключения задачи. (Унаследовано от DbDataReader)
GetStream(Int32)	Возвращает поток для получения данных из указанного столбца. (Унаследовано от DbDataReader)
GetString(Int32)	Возвращает значение заданного столбца в виде объекта String.
GetTextReader(Int32)	Получает модуль чтения текста для извлечения данных из столбца. (Унаследовано от DbDataReader)
GetTime(Int32)	Возвращает значение указанного столбца в виде объекта TimeSpan.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValue(Int32)	Получает значение столбца с указанным порядковом номером в собственном формате.
GetValues(Object[])	Заполняет массив объектов значениями столбцов текущей строки.
IsDBNull(Int32)	Возвращает значение, указывающее, содержатся ли в столбце несуществующие или отсутствующие значения.
IsDBNullAsync(Int32)	Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения. (Унаследовано от DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения. (Унаследовано от DbDataReader)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
NextResult()	Перемещает объект OdbcDataReader в следующий результат, когда выполняется чтение результатов пакетных операторов SQL.
NextResultAsync()	Асинхронно перемещает модуль чтения данных к следующему результату при чтении результатов из пакета инструкций. (Унаследовано от DbDataReader)
NextResultAsync(CancellationToken)	Асинхронно перемещает модуль чтения данных к следующему результату при чтении результатов из пакета инструкций. (Унаследовано от DbDataReader)
Read()	Перемещает OdbcDataReader к следующей записи.
ReadAsync()	Асинхронно перемещает модуль чтения к следующей записи в результирующем наборе. (Унаследовано от DbDataReader)
ReadAsync(CancellationToken)	Асинхронно перемещает модуль чтения к следующей записи в результирующем наборе. (Унаследовано от DbDataReader)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

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

• Объекты DataAdapter и DataReader