DbCommand.ExecuteScalarAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
비동기 버전을 ExecuteScalar()구현하지만 동기적으로 반환 Task 하여 호출 스레드를 차단합니다.
오버로드
| Name | Description |
|---|---|
| ExecuteScalarAsync() |
명령을 실행하고 반환된 첫 번째 결과 집합에서 ExecuteScalar()첫 번째 행의 첫 번째 열을 반환하는 비동기 버전입니다. 다른 모든 열, 행 및 결과 집합은 무시됩니다. CancellationToken.None을 사용하여 호출합니다 ExecuteScalarAsync(CancellationToken) . |
| ExecuteScalarAsync(CancellationToken) |
이 버전은 .의 비동기 버전입니다 ExecuteScalar(). 공급자는 적절한 구현으로 재정의해야 합니다. 취소 토큰은 선택적으로 무시될 수 있습니다. 기본 구현은 동기 ExecuteScalar() 메서드를 호출하고 완료된 작업을 반환하여 호출 스레드를 차단합니다. 이미 취소된 취소 토큰을 전달한 경우 기본 구현은 취소된 작업을 반환합니다. ExecuteScalar에서 throw된 예외는 반환된 작업 예외 속성을 통해 전달됩니다. 반환된 작업이 완료될 때까지 개체의 |
설명
비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.
ExecuteScalarAsync()
명령을 실행하고 반환된 첫 번째 결과 집합에서 ExecuteScalar()첫 번째 행의 첫 번째 열을 반환하는 비동기 버전입니다. 다른 모든 열, 행 및 결과 집합은 무시됩니다.
CancellationToken.None을 사용하여 호출합니다 ExecuteScalarAsync(CancellationToken) .
public:
System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();public System.Threading.Tasks.Task<object> ExecuteScalarAsync();member this.ExecuteScalarAsync : unit -> System.Threading.Tasks.Task<obj>Public Function ExecuteScalarAsync () As Task(Of Object)반품
비동기 작업을 나타내는 작업입니다.
예외
명령을 실행하는 동안 오류가 발생했습니다.
설명
비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 ExecuteScalar()throw된 예외를 참조하세요.
추가 정보
적용 대상
ExecuteScalarAsync(CancellationToken)
이 버전은 .의 비동기 버전입니다 ExecuteScalar(). 공급자는 적절한 구현으로 재정의해야 합니다. 취소 토큰은 선택적으로 무시될 수 있습니다.
기본 구현은 동기 ExecuteScalar() 메서드를 호출하고 완료된 작업을 반환하여 호출 스레드를 차단합니다. 이미 취소된 취소 토큰을 전달한 경우 기본 구현은 취소된 작업을 반환합니다. ExecuteScalar에서 throw된 예외는 반환된 작업 예외 속성을 통해 전달됩니다.
반환된 작업이 완료될 때까지 개체의 DbCommand 다른 메서드와 속성을 호출하지 마세요.
public:
virtual System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<object> ExecuteScalarAsync(System.Threading.CancellationToken cancellationToken);abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>Public Overridable Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)매개 변수
- cancellationToken
- CancellationToken
비동기 작업을 취소하는 토큰입니다.
반품
비동기 작업을 나타내는 작업입니다.
예외
명령을 실행하는 동안 오류가 발생했습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 ExecuteScalar()throw된 예외를 참조하세요.