SqlDataReader.IsDBNullAsync(Int32, CancellationToken) 메서드


존재하지 않거나 누락된 값이 열에 포함되었는지 여부를 나타내는 값을 가져오는 IsDBNull(Int32)의 비동기 버전입니다.An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values.

취소 토큰은 명령 제한 시간이 경과하기 전에 작업을 중단하는 요청에 사용할 수 있습니다.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. 예외는 반환된 작업 개체를 통해 보고됩니다.Exceptions will be reported via the returned Task object.

 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>

매개 변수


검색할 열입니다(0부터 시작).The zero-based column to be retrieved.


작업을 취소해야 한다는 알림을 전파하는 취소 명령입니다.The cancellation instruction, which propagates a notification that operations should be canceled. 취소를 보장하지는 않습니다.This does not guarantee the cancellation. CancellationToken.None을 설정하면 이 메서드가 IsDBNull(Int32)와 동일해집니다.A setting of CancellationToken.None makes this method equivalent to IsDBNull(Int32). 반환된 작업은 취소로 표시되어 있어야 합니다.The returned task must be marked as cancelled.


지정된 열 값이 true과 같으면 DBNull이고, 그렇지 않으면 false입니다.true if the specified column value is equivalent to DBNull otherwise false.


데이터 검색 중 연결이 끊기거나 닫힌 경우The connection drops or is closed during the data retrieval.

데이터 검색 중 SqlDataReader가 닫힌 경우The SqlDataReader is closed during the data retrieval.

읽을 준비가 된 데이터가 없는 경우(예를 들어, 첫 번째 Read()가 호출되지 않았거나 false를 반환한 경우)There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

순차 모드에서 이전에 읽은 열을 읽으려고 했습니다.Trying to read a previously read column in sequential mode.

진행 중인 비동기 작업이 없습니다.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.

Context Connection=true가 연결 문자열에 지정되어 있습니다.Context Connection=true is specified in the connection string.

존재하지 않는 열을 읽으려고 시도합니다.Trying to read a column that does not exist.


자세한 내용은 SqlClient 스트리밍 지원을 참조 하세요.For more information, see SqlClient Streaming Support.

적용 대상