DbDataReader.GetFieldValueAsync DbDataReader.GetFieldValueAsync DbDataReader.GetFieldValueAsync DbDataReader.GetFieldValueAsync Method

Определение

Асинхронно возвращает значение указанного столбца в виде запрошенного типа.Asynchronously gets the value of the specified column as the requested type.

Перегрузки

GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32)

Асинхронно возвращает значение указанного столбца в виде запрошенного типа.Asynchronously gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken)

Асинхронно возвращает значение указанного столбца в виде запрошенного типа.Asynchronously gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32)

Асинхронно возвращает значение указанного столбца в виде запрошенного типа.Asynchronously gets the value of the specified column as the requested type.

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

Тип возвращаемого значения.The type of the value to be returned.

Параметры

ordinal
Int32 Int32 Int32 Int32

Порядковый номер столбца (от нуля).The zero-based column ordinal.

Возвраты

Task<T>

Задача, Result которой содержит значение заданного столбца.A task whose Result contains the value of the specified column.

Исключения

Соединение было удалено или закрыто во время получения данных.The connection was dropped or closed during data retrieval.

- или --or-

Модуль чтения данных был закрыт во время получения данных.The data reader was closed during the data retrieval.

-или--or-

Не существует данных, готовых для чтения (например, первый объект Read() не был вызван или вернул значение false).There is no data ready to be read (for example, the first Read() hasn't been called, or it returned false).

-или--or-

Сделана попытка чтения ранее считанного столбца в последовательном режиме.Tried to read a previously-read column in sequential mode.

- или --or-

Выполнялась асинхронная операция.There was an asynchronous operation in progress. Относится ко всем методам Get_* при работе в последовательном режиме, так как они могут вызываться при чтении потока.This applies to all Get*_ methods when running in sequential mode, as they could be called while reading a stream.

Индекс столбца находится за пределами диапазона.The column index is out of range.

Значение, возвращенное базой данных, не соответствует типу T или не может быть приведено к нему.The value returned by the database doesn't match or cannot be cast to T.

Комментарии

Этот асинхронный метод необходим, чтобы не блокировать вызывающий поток при создании модуля чтения в последовательном режиме.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Если последовательный режим не указан, все значения столбцов должны быть доступны в памяти каждый раз, когда ReadAsync завершается, а вызов синхронной версии метода не должен блокировать вызывающий поток.If sequential mode isn't specified, all column values should become available in memory each time ReadAsync completes, and calling the synchronous version of the method shouldn't block the calling thread.

Реализация этого асинхронного метода по умолчанию вызывает его синхронный аналог и возвращает завершенную задачу, потенциально блокируя вызывающий поток.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.

Поставщики данных, поддерживающие Асинхронное программирование , должны переопределять реализацию по умолчанию с помощью асинхронных операций ввода-вывода.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Другие методы и свойства объекта DbDataReader не должны вызываться, когда возвращаемая задача еще не завершена.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken)

Асинхронно возвращает значение указанного столбца в виде запрошенного типа.Asynchronously gets the value of the specified column as the requested type.

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>

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

T

Тип возвращаемого значения.The type of the value to be returned.

Параметры

ordinal
Int32 Int32 Int32 Int32

Порядковый номер столбца (от нуля).The zero-based column ordinal.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Токен для отмены асинхронной операции.A token to cancel the asynchronous operation.

Возвраты

Task<T>

Задача, Result которой содержит значение заданного столбца.A task whose Result contains the value of the specified column.

Исключения

Соединение было удалено или закрыто во время получения данных.The connection was dropped or closed during data retrieval.

-или--or-

Модуль чтения данных был закрыт во время получения данных.The data reader was closed during the data retrieval.

- или --or-

Не существует данных, готовых для чтения (например, первый объект Read() не был вызван или вернул значение false).There is no data ready to be read (for example, the first Read() hasn't been called, or it returned false).

- или --or-

Сделана попытка чтения ранее считанного столбца в последовательном режиме.Tried to read a previously-read column in sequential mode.

-или--or-

Выполнялась асинхронная операция.There was an asynchronous operation in progress. Относится ко всем методам Get_* при работе в последовательном режиме, так как они могут вызываться при чтении потока.This applies to all Get*_ methods when running in sequential mode, as they could be called while reading a stream.

Индекс столбца находится за пределами диапазона.The column index is out of range.

Значение, возвращенное базой данных, не соответствует типу T или не может быть приведено к нему.The value returned by the database doesn't match or cannot be cast to T.

Комментарии

Этот асинхронный метод необходим, чтобы не блокировать вызывающий поток при создании модуля чтения в последовательном режиме.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Если последовательный режим не указан, все значения столбцов должны быть доступны в памяти каждый раз, когда ReadAsync завершается, а вызов синхронной версии метода не должен блокировать вызывающий поток.If sequential mode isn't specified, all column values should become available in memory each time ReadAsync completes, and calling the synchronous version of the method shouldn't block the calling thread.

Реализация этого асинхронного метода по умолчанию вызывает его синхронный аналог и возвращает завершенную задачу, потенциально блокируя вызывающий поток.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread. Реализация по умолчанию также возвращает отмененную задачу, если она передала уже отмененный токен отмены.The default implementation also returns a cancelled task if passed an already cancelled cancellation token.

Поставщики данных, поддерживающие Асинхронное программирование , должны переопределять реализацию по умолчанию с помощью асинхронных операций ввода-вывода.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Этот метод принимает токен отмены, который может использоваться для запроса ранней отмены операции.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Реализации могут игнорировать данный запрос.Implementations may ignore this request.

Другие методы и свойства объекта DbDataReader не должны вызываться, когда возвращаемая задача еще не завершена.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

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