DbDataReader.IsDBNullAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
열에 존재하지 않거나 누락된 값이 포함되어 있는지 여부를 나타내는 값을 비동기적으로 가져옵니다.
오버로드
| Name | Description |
|---|---|
| IsDBNullAsync(Int32) |
열에 존재하지 않거나 누락된 값이 포함되어 있는지 여부를 나타내는 값을 비동기적으로 가져옵니다. |
| IsDBNullAsync(Int32, CancellationToken) |
열에 존재하지 않거나 누락된 값이 포함되어 있는지 여부를 나타내는 값을 비동기적으로 가져옵니다. |
IsDBNullAsync(Int32)
열에 존재하지 않거나 누락된 값이 포함되어 있는지 여부를 나타내는 값을 비동기적으로 가져옵니다.
public:
System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int ordinal);public System.Threading.Tasks.Task<bool> IsDBNullAsync(int ordinal);member this.IsDBNullAsync : int -> System.Threading.Tasks.Task<bool>Public Function IsDBNullAsync (ordinal As Integer) As Task(Of Boolean)매개 변수
- ordinal
- Int32
검색할 열(0부터 시작)입니다.
반품
Task<TResult>
Result 지정된 열 값이 true 같은 DBNull 경우 또는 false 그렇지 않은 경우 해당 속성입니다.
예외
데이터 검색 중에 연결이 끊어지거나 닫혔습니다.
-또는-
데이터 판독기는 데이터 검색 중에 닫힙니다.
-또는-
읽을 준비가 된 데이터가 없습니다(예: 첫 번째 Read() 데이터가 호출되지 않았거나 false로 반환됨).
-또는-
순차 모드에서 이전에 읽은 열을 읽으려고 합니다.
-또는-
진행 중인 비동기 작업이 있었습니다. 이는 스트림을 읽는 동안 호출할 수 있으므로 순차 모드로 실행할 때 모든 Get* 메서드에 적용됩니다.
열 인덱스가 범위를 벗어났습니다.
설명
이 비동기 메서드는 판독기를 순차 모드로 만들 때 호출 스레드가 차단되지 않도록 하기 위해서만 필요합니다.
순차 모드를 지정하지 않으면 ReadAsync가 완료될 때마다 모든 열 값을 메모리에서 사용할 수 있어야 하며, 메서드의 동기 버전을 호출해도 호출 스레드가 차단되지 않아야 합니다.
이 비동기 메서드의 기본 구현은 해당 동기 메서드를 호출하고 완료된 작업을 반환하여 호출 스레드를 차단할 수 있습니다.
비동기 프로그래밍을 지원하는 데이터 공급자는 비동기 I/O 작업을 사용하여 기본 구현을 재정의해야 합니다.
반환된 Task가 아직 완료되지 않은 동안에는 DbDataReader 개체의 다른 메서드와 속성을 호출하면 안 됩니다.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 IsDBNull(Int32)throw된 예외를 참조하세요.
적용 대상
IsDBNullAsync(Int32, CancellationToken)
열에 존재하지 않거나 누락된 값이 포함되어 있는지 여부를 나타내는 값을 비동기적으로 가져옵니다.
public:
virtual System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int ordinal, System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<bool> IsDBNullAsync(int ordinal, System.Threading.CancellationToken cancellationToken);abstract member IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function IsDBNullAsync (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)매개 변수
- ordinal
- Int32
검색할 열(0부터 시작)입니다.
- cancellationToken
- CancellationToken
비동기 작업을 취소하는 토큰입니다.
반품
Task<TResult>
Result 지정된 열 값이 true 같은 DBNull 경우 또는 false 그렇지 않은 경우 해당 속성입니다.
예외
데이터 검색 중에 연결이 끊어지거나 닫혔습니다.
-또는-
데이터 판독기는 데이터 검색 중에 닫힙니다.
-또는-
읽을 준비가 된 데이터가 없습니다(예: 첫 번째 Read() 데이터가 호출되지 않았거나 false로 반환됨).
-또는-
순차 모드에서 이전에 읽은 열을 읽으려고 합니다.
-또는-
진행 중인 비동기 작업이 있었습니다. 이는 스트림을 읽는 동안 호출할 수 있으므로 순차 모드로 실행할 때 모든 Get* 메서드에 적용됩니다.
열 인덱스가 범위를 벗어났습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
이 비동기 메서드는 판독기를 순차 모드로 만들 때 호출 스레드가 차단되지 않도록 하기 위해서만 필요합니다.
순차 모드를 지정하지 않으면 ReadAsync가 완료될 때마다 모든 열 값을 메모리에서 사용할 수 있어야 하며, 메서드의 동기 버전을 호출해도 호출 스레드가 차단되지 않아야 합니다.
이 비동기 메서드의 기본 구현은 해당 동기 메서드를 호출하고 완료된 작업을 반환하여 호출 스레드를 차단할 수 있습니다. 이미 취소된 취소 토큰을 전달한 경우에도 기본 구현은 취소된 작업을 반환합니다.
비동기 프로그래밍을 지원하는 데이터 공급자는 비동기 I/O 작업을 사용하여 기본 구현을 재정의해야 합니다.
이 메서드는 작업을 일찍 취소하도록 요청하는 데 사용할 수 있는 취소 토큰을 허용합니다. 구현에서는 이 요청을 무시할 수 있습니다.
반환된 Task가 아직 완료되지 않은 동안에는 DbDataReader 개체의 다른 메서드와 속성을 호출하면 안 됩니다. 이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 IsDBNull(Int32)throw된 예외를 참조하세요.