SqlDataReader.IsDBNullAsync(Int32, CancellationToken) 메서드

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.SqlClient.dll

패키지:

System.Data.SqlClient v4.9.0

Source:

System.Data.SqlClient.notsupported.cs

존재하지 않거나 누락된 값이 열에 포함되었는지 여부를 나타내는 값을 가져오는 IsDBNull(Int32)의 비동기 버전입니다.

취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.

public:
 override System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int i, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<bool> IsDBNullAsync (int i, System.Threading.CancellationToken cancellationToken);

override this.IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overrides Function IsDBNullAsync (i As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)

매개 변수

i

Int32

검색할 열입니다(0부터 시작).

cancellationToken

CancellationToken

작업을 취소해야 한다는 알림을 전파하는 취소 명령입니다. 취소를 보장하지는 않습니다. CancellationToken.None을 설정하면 이 메서드가 IsDBNull(Int32)와 동일해집니다. 반환된 작업은 취소로 표시되어 있어야 합니다.

반환

Task<Boolean>

지정된 열 값이 true과 같으면 DBNull이고, 그렇지 않으면 false입니다.

예외

InvalidOperationException

데이터 검색 중 연결이 끊기거나 닫힌 경우

데이터 검색 중 SqlDataReader가 닫힌 경우

읽을 준비가 된 데이터가 없는 경우(예를 들어, 첫 번째 Read()가 호출되지 않았거나 false를 반환한 경우)

순차 모드에서 이전에 읽은 열을 읽으려고 했습니다.

진행 중인 비동기 작업이 없습니다. 이는 스트림을 읽는 동안 호출할 수 있기 때문에 순차 모드로 실행할 때 모든 Get* 메서드에 적용됩니다.

Context Connection=true가 연결 문자열에 지정되어 있습니다.

IndexOutOfRangeException

존재하지 않는 열을 읽으려고 시도합니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw IsDBNull(Int32)된 예외를 참조하세요.