SqlCommand.ExecuteScalarAsync(CancellationToken) 메서드

정의

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

쿼리를 비동기적으로 실행하고 쿼리에서 반환된 결과 집합의 첫 번째 행의 첫 번째 열을 반환하는 ExecuteScalar()의 비동기 버전입니다. 추가 열이나 행은 무시됩니다.

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

public:
 override System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<object> ExecuteScalarAsync (System.Threading.CancellationToken cancellationToken);

override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>

Public Overrides Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)

취소 명령입니다.

비동기 작업(operation)을 나타내는 작업(task)입니다.

이 SqlDbType 진 또는 VarBinary 이외의 다른 형식은 로 설정된 Stream경우 Value 사용되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

또는

SqlDbType Char, NChar, NVarChar, VarChar 또는 Xml 이외의 다른 형식이 사용 Value 되었습니다TextReader.

또는

SqlDbType 로 설정된 XmlReader경우 Value Xml 이외의 다른 코드가 사용되었습니다.

작업 완료 전에 동일한 인스턴스에 대해 ExecuteScalarAsync(CancellationToken)를 두 번 이상 호출

또는

스트리밍 작업 동안 SqlConnection이 닫히거나 삭제되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

또는

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

SqlException

SQL Server에서 명령 텍스트를 실행하는 동안 오류를 반환했습니다.

또는

스트리밍 작업 동안 시간이 초과되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

IOException

스트리밍 작업 동안 Stream, XmlReader 또는 TextReader 개체에서 오류가 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

스트리밍 작업 동안 Stream, XmlReader 또는 TextReader 개체가 닫혔습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

SQL Server 대한 .NET Framework Data Provider 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.