SqlDataReader.GetFieldValueAsync<T>(Int32, CancellationToken) 메서드

정의

네임스페이스:
System.Data.SqlClient
어셈블리:
System.Data.dll

지정된 열의 값을 형식으로 비동기적으로 가져옵니다. 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 은 다음 형식 중 하나일 수 있습니다.

부울, 바이트, 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 스트리밍 지원을 참조하세요.

적용 대상