SqlDataReader.GetFieldValueAsync<T>(Int32, CancellationToken) Метод

Определение

Пространство имен:
System.Data.SqlClient
Сборка:
System.Data.SqlClient.dll
Сборка:
System.Data.dll
Исходный код:
System.Data.SqlClient.notsupported.cs

Асинхронно получает значение указанного столбца в виде типа. GetFieldValue<T>(Int32) — синхронная версия этого метода.

public:
generic <typename T>
 override System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int i, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<T> GetFieldValueAsync<T>(int i, System.Threading.CancellationToken cancellationToken);
override this.GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>
Public Overrides Function GetFieldValueAsync(Of T) (i As Integer, cancellationToken As CancellationToken) As Task(Of T)

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

T

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

Параметры

i
Int32

Извлекаемого столбца.

cancellationToken
CancellationToken

Инструкция отмены, которая распространяет уведомление об отмене операций. Это не гарантирует отмену. Параметр CancellationToken.None делает этот метод эквивалентным IsDBNull(Int32). Возвращаемая задача должна быть помечена как отмененная.

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

Task<T>

Возвращаемый объект типа.

Исключения

InvalidOperationException

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

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

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

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

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

Context Connection=true указывается в строка подключения.

IndexOutOfRangeException

Попытка считывать столбец, который не существует.

SqlNullValueException

Значение столбца было null (IsDBNull(Int32) == true), извлекая тип, отличный от SQL.

InvalidCastException

T не соответствует типу, возвращаемого SQL Server или не может быть приведение.

OperationCanceledException

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

Комментарии

T Может быть одним из следующих типов:

Boolean, Byte, Char, DateTime, DateTimeOffset, Decimal, Double, Float, Guid, Int16, Int32, Int64, SqlBoolean, SqlByte, SqlDateTime, SqlDecimal, SqlDouble, SqlGuid, SqlInt16, SqlInt32, SqlInt64, SqlMoney, SqlSingle, SqlString, String или UDT (любой тип CLR, помеченный как SqlUserDefinedTypeAttribute).

Дополнительные сведения см. в разделе "Поддержка потоковой передачи SqlClient".

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