OdbcDataReader Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет способ чтения потока данных только для перенаправления строк данных из источника данных. Этот класс не наследуется.
public ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReaderpublic ref class OdbcDataReader sealed : System::Data::Common::DbDataReaderpublic sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReaderpublic sealed class OdbcDataReader : System.Data.Common.DbDataReadertype OdbcDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDataRecord
interface IDisposable
interface IEnumerabletype OdbcDataReader = class
inherit DbDataReaderPublic NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerablePublic NotInheritable Class OdbcDataReader
Inherits DbDataReader- Наследование
- Наследование
- Реализации
Примеры
В следующем примере создается OdbcConnectionобъект , а OdbcCommandтакже объект OdbcDataReader. Пример считывает данные, записывая его в консоль. Наконец, пример закрывает 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 Закрывает объект. |
| CreateObjRef(Type) |
Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
| Dispose() |
Освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader. (Унаследовано от DbDataReader) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые DbDataReader и при необходимости освобождает управляемые ресурсы. (Унаследовано от DbDataReader) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| Finalize() |
Позволяет объекту пытаться освободить ресурсы и выполнять другие операции очистки перед его восстановлением сборкой мусора. |
| GetBoolean(Int32) |
Возвращает значение указанного столбца как логическое значение. |
| GetByte(Int32) |
Возвращает значение указанного столбца в виде байта. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Считывает поток байтов из указанного смещения столбца в буфер в виде массива, начиная с определенного смещения буфера. |
| GetChar(Int32) |
Возвращает значение указанного столбца в виде символа. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Считывает поток символов из указанного смещения столбца в буфер в виде массива, начиная с определенного смещения буфера. |
| GetData(Int32) |
IDataReader Возвращает порядковый номер указанного столбца. |
| 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, CancellationToken) |
Асинхронно получает значение указанного столбца в качестве запрошенного типа. (Унаследовано от DbDataReader) |
| GetFieldValueAsync<T>(Int32) |
Асинхронно получает значение указанного столбца в качестве запрошенного типа. (Унаследовано от 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 , описывающее метаданные столбца OdbcDataReader. |
| GetStream(Int32) |
Получает поток для получения данных из указанного столбца. (Унаследовано от DbDataReader) |
| GetString(Int32) |
Возвращает значение указанного столбца в виде String. |
| GetTextReader(Int32) |
Получает средство чтения текста для получения данных из столбца. (Унаследовано от DbDataReader) |
| GetTime(Int32) |
Возвращает значение указанного столбца в качестве TimeSpan объекта. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetValue(Int32) |
Возвращает значение столбца в указанном порядковом номере в собственном формате. |
| GetValues(Object[]) |
Заполняет массив объектов значениями столбцов текущей строки. |
| InitializeLifetimeService() |
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| IsDBNull(Int32) |
Возвращает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения. |
| IsDBNullAsync(Int32, CancellationToken) |
Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения. (Унаследовано от DbDataReader) |
| IsDBNullAsync(Int32) |
Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения. (Унаследовано от DbDataReader) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| MemberwiseClone(Boolean) |
Создает неглубокую копию текущего MarshalByRefObject объекта. (Унаследовано от MarshalByRefObject) |
| NextResult() |
Переходит к следующему результату OdbcDataReader при чтении результатов пакетных инструкций SQL. |
| NextResultAsync() |
Асинхронно перемещает средство чтения к следующему результату при чтении результатов пакета инструкций. (Унаследовано от DbDataReader) |
| NextResultAsync(CancellationToken) |
Асинхронно перемещает средство чтения к следующему результату при чтении результатов пакета инструкций. (Унаследовано от DbDataReader) |
| Read() |
Перемещает следующую OdbcDataReader запись. |
| ReadAsync() |
Асинхронно перемещает средство чтения к следующей записи в результирующем наборе. (Унаследовано от DbDataReader) |
| ReadAsync(CancellationToken) |
Асинхронно перемещает средство чтения к следующей записи в результирующем наборе. (Унаследовано от DbDataReader) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| IDataRecord.GetData(Int32) |
Описание этого элемента см. в разделе GetData(Int32). (Унаследовано от DbDataReader) |
| IDisposable.Dispose() |
Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода. Освобождает все ресурсы, используемые текущим экземпляром класса OdbcDataReader. |
| IEnumerable.GetEnumerator() |
Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода. Возвращает перечислитель, который выполняет итерацию по коллекции. |
Методы расширения
| Имя | Описание |
|---|---|
| AsParallel(IEnumerable) |
Включает параллелизацию запроса. |
| AsQueryable(IEnumerable) |
Преобразует IEnumerable в IQueryable. |
| CanGetColumnSchema(DbDataReader) |
Возвращает значение, указывающее, может ли получить DbDataReader схему столбца. |
| Cast<TResult>(IEnumerable) |
Приведение элементов IEnumerable к указанному типу. |
| GetColumnSchema(DbDataReader) |
Возвращает схему столбца (DbColumnколлекцию) для .DbDataReader |
| OfType<TResult>(IEnumerable) |
Фильтрует элементы IEnumerable на основе указанного типа. |