OdbcDataReader Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет способ чтения потока строк данных из источника только в прямом порядке. Этот класс не наследуется.
public ref class OdbcDataReader sealed : System::Data::Common::DbDataReader
public ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OdbcDataReader : System.Data.Common.DbDataReader
public sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OdbcDataReader = class
inherit DbDataReader
type OdbcDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDataRecord
interface IDisposable
interface IEnumerable
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
Public NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
- Наследование
- Наследование
- Реализации
Примеры
В следующем примере создаются 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) |
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).
Поставщики должны выполнить переопределение с помощью соответствующей реализации.
При необходимости можно учитывать |
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) |
Асинхронно возвращает значение указанного столбца в виде запрошенного типа. (Унаследовано от 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, описывающий метаданные столбцов модуля чтения данных OdbcDataReader. |
GetSchemaTableAsync(CancellationToken) |
Это асинхронная версия метода GetSchemaTable().
Поставщики должны выполнить переопределение с помощью соответствующей реализации.
При необходимости можно учитывать |
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) |
Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения. (Унаследовано от DbDataReader) |
IsDBNullAsync(Int32, CancellationToken) |
Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения. (Унаследовано от 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 поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода. Возвращает перечислитель, который осуществляет итерацию по коллекции. |
Методы расширения
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) |
Настраивает способ выполнения ожиданий для задач, возвращаемых из асинхронного высвобождаемого объекта. |
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по