DbCommand.ExecuteScalarAsync 메서드

정의

ExecuteScalar()의 비동기 버전을 구현하지만 Task를 동기적으로 반환하여 호출 스레드를 차단합니다.Implements the asynchronous version of ExecuteScalar(), but returns a Task synchronously, blocking the calling thread.

오버로드

ExecuteScalarAsync()

쿼리를 실행하고 쿼리에서 반환된 결과 집합의 첫 번째 행의 첫 번째 열을 반환하는 ExecuteScalar()의 비동기 버전입니다.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. 다른 모든 열과 행은 무시됩니다.All other columns and rows are ignored.

CancellationToken.None을 사용하여 ExecuteScalarAsync(CancellationToken)를 호출합니다.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

ExecuteScalarAsync(CancellationToken)

ExecuteScalar()의 비동기 버전입니다.This is the asynchronous version of ExecuteScalar(). 공급자는 적절한 구현을 재정의해야 합니다.Providers should override with an appropriate implementation. 취소 토큰은 선택적으로 무시될 수 있습니다.The cancellation token may optionally be ignored.

기본 구현은 동기 ExecuteScalar() 메서드를 호출하고, 호출 스레드를 차단하면서 완료된 작업을 반환합니다.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. 기본 구현은 이미 취소된 취소 토큰을 전달하는 경우 취소된 작업을 반환합니다.The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteScalar에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

반환된 작업이 완료될 때까지 DbCommand 개체의 다른 메서드 및 속성을 호출하지 마십시오.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

설명

비동기 프로그래밍에 대 한 자세한 내용은 비동기 프로그래밍을 참조 하세요.For more information about asynchronous programming, see Asynchronous Programming.

ExecuteScalarAsync()

쿼리를 실행하고 쿼리에서 반환된 결과 집합의 첫 번째 행의 첫 번째 열을 반환하는 ExecuteScalar()의 비동기 버전입니다.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. 다른 모든 열과 행은 무시됩니다.All other columns and rows are ignored.

CancellationToken.None을 사용하여 ExecuteScalarAsync(CancellationToken)를 호출합니다.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

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)

반환

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

예외

명령 텍스트를 실행하는 동안 오류가 발생했습니다.An error occurred while executing the command text.

설명

비동기 프로그래밍에 대 한 자세한 내용은 비동기 프로그래밍을 참조 하세요.For more information about asynchronous programming, see Asynchronous Programming.

추가 정보

ExecuteScalarAsync(CancellationToken)

ExecuteScalar()의 비동기 버전입니다.This is the asynchronous version of ExecuteScalar(). 공급자는 적절한 구현을 재정의해야 합니다.Providers should override with an appropriate implementation. 취소 토큰은 선택적으로 무시될 수 있습니다.The cancellation token may optionally be ignored.

기본 구현은 동기 ExecuteScalar() 메서드를 호출하고, 호출 스레드를 차단하면서 완료된 작업을 반환합니다.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. 기본 구현은 이미 취소된 취소 토큰을 전달하는 경우 취소된 작업을 반환합니다.The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteScalar에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

반환된 작업이 완료될 때까지 DbCommand 개체의 다른 메서드 및 속성을 호출하지 마십시오.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

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>

매개 변수

cancellationToken
CancellationToken

비동기 작업을 취소하기 위한 토큰입니다.A token to cancel the asynchronous operation.

반환

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

예외

명령 텍스트를 실행하는 동안 오류가 발생했습니다.An error occurred while executing the command text.

설명

비동기 프로그래밍에 대 한 자세한 내용은 비동기 프로그래밍을 참조 하세요.For more information about asynchronous programming, see Asynchronous Programming.

추가 정보

적용 대상