DbDataReader.GetFieldValueAsync Метод

Определение

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

System.Data.Common

Сборки:

netstandard.dll, System.Data.Common.dll

Асинхронно получает значение указанного столбца в качестве запрошенного типа.

Перегрузки

Имя	Описание
GetFieldValueAsync<T>(Int32)	Асинхронно получает значение указанного столбца в качестве запрошенного типа.
GetFieldValueAsync<T>(Int32, CancellationToken)	Асинхронно получает значение указанного столбца в качестве запрошенного типа.

GetFieldValueAsync<T>(Int32)

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

DbDataReader.cs

Асинхронно получает значение указанного столбца в качестве запрошенного типа.

public:
generic <typename T>
 System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int ordinal);

public System.Threading.Tasks.Task<T> GetFieldValueAsync<T>(int ordinal);

member this.GetFieldValueAsync : int -> System.Threading.Tasks.Task<'T>

Public Function GetFieldValueAsync(Of T) (ordinal As Integer) As Task(Of T)

Параметры типа

T

Тип возвращаемого значения.

Параметры

ordinal

Int32

Порядковый номер столбца от нуля.

Возвращаемое значение

Task<T>

Задача, содержащая Result значение указанного столбца.

Исключения

InvalidOperationException

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

–или–

Средство чтения данных было закрыто во время извлечения данных.

–или–

Нет данных, готовых к чтению (например, первый Read() не был вызван или возвращен).false

–или–

Попыталась считывать столбец ранее считываемого в последовательном режиме.

–или–

Выполняется асинхронная операция. Это относится ко всем методам Get_*_ при выполнении в последовательном режиме, так как они могут вызываться при чтении потока.

IndexOutOfRangeException

Индекс столбца выходит за пределы диапазона.

InvalidCastException

Значение, возвращаемое базой данных, не соответствует или не может быть приведение к T.

Комментарии

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

Если последовательный режим не указан, все значения столбцов должны быть доступны в памяти при каждом завершении ReadAsync, и вызов синхронной версии метода не должен блокировать вызывающий поток.

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

Поставщики данных, поддерживающие асинхронное программирование, должны переопределить реализацию по умолчанию с помощью асинхронных операций ввода-вывода.

Другие методы и свойства объекта DbDataReader не должны вызываться, пока возвращенная задача еще не завершена.

GetFieldValueAsync<T>(Int32, CancellationToken)

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

DbDataReader.cs

Асинхронно получает значение указанного столбца в качестве запрошенного типа.

public:
generic <typename T>
 virtual System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int ordinal, System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<T> GetFieldValueAsync<T>(int ordinal, System.Threading.CancellationToken cancellationToken);

abstract member GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>
override this.GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>

Public Overridable Function GetFieldValueAsync(Of T) (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of T)

Параметры типа

T

Тип возвращаемого значения.

Параметры

ordinal

Int32

Порядковый номер столбца от нуля.

cancellationToken

CancellationToken

Маркер для отмены асинхронной операции.

Возвращаемое значение

Task<T>

Задача, содержащая Result значение указанного столбца.

Исключения

InvalidOperationException

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

–или–

Средство чтения данных было закрыто во время извлечения данных.

–или–

Нет данных, готовых к чтению (например, первый Read() не был вызван или возвращен).false

–или–

Попыталась считывать столбец ранее считываемого в последовательном режиме.

–или–

Выполняется асинхронная операция. Это относится ко всем методам Get_*_ при выполнении в последовательном режиме, так как они могут вызываться при чтении потока.

IndexOutOfRangeException

Индекс столбца выходит за пределы диапазона.

InvalidCastException

Значение, возвращаемое базой данных, не соответствует или не может быть приведение к T.

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

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

Если последовательный режим не указан, все значения столбцов должны быть доступны в памяти при каждом завершении ReadAsync, и вызов синхронной версии метода не должен блокировать вызывающий поток.

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

Поставщики данных, поддерживающие асинхронное программирование, должны переопределить реализацию по умолчанию с помощью асинхронных операций ввода-вывода.

Этот метод принимает маркер отмены, который можно использовать для запроса на отмену операции раньше. Реализации могут игнорировать этот запрос.

Другие методы и свойства объекта DbDataReader не должны вызываться, пока возвращенная задача еще не завершена.