SqlCommand.ExecuteScalarAsync(CancellationToken) 메서드

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

쿼리를 비동기적으로 실행하고 쿼리에서 반환된 결과 집합에서 첫 번째 행의 첫 번째 열을 반환하는 의 비동기 버전 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)

매개 변수

cancellationToken

CancellationToken

취소 명령입니다.

반환

Task<Object>

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

예외

ArgumentException

CommandBehavior 값이 잘못되었습니다.

InvalidCastException

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

또는

이 SqlDbType 로 설정된 TextReader 경우 ValueChar, NChar, NVarChar, VarChar 또는 Xml 이외의 가 사용되었습니다.

또는

이 로 SqlDbType 설정 XmlReader 되었을 때 ValueXml 이외의 가 사용되었습니다.

InvalidOperationException

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

또는

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

SqlException

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

또는

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

IOException

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

ObjectDisposedException

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

설명

SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

참고

서버에서 장기 실행 쿼리의 경우 취소 토큰을 통해 쿼리를 취소하는 알려진 문제로 인해 를 사용하는 ExecuteScalar 것이 좋습니다. 또한 메서드를 사용하여 실행을 취소하는 것이 Cancel 좋습니다.