SqlConnection.OpenAsync(CancellationToken) 메서드

정의

네임스페이스:
System.Data.SqlClient
어셈블리:
System.Data.dll

에 지정된 Open()속성 설정과 데이터베이스 연결을 여는 비동기 버전ConnectionString입니다. 취소 토큰을 사용하여 연결 시간 초과가 경과하기 전에 작업을 중단하도록 요청할 수 있습니다. 예외는 반환된 작업을 통해 전파됩니다. 연결 시간이 성공적으로 연결되지 않고 경과하면 반환된 작업이 예외로 오류로 표시됩니다. 구현은 풀링된 연결과 풀링되지 않은 연결 모두에 대한 호출 스레드를 차단하지 않고 Task를 반환합니다.

public:
 override System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function OpenAsync (cancellationToken As CancellationToken) As Task

매개 변수

cancellationToken
CancellationToken

취소 명령입니다.

반품

Task

비동기 작업을 나타내는 작업입니다.

예외

InvalidOperationException

작업이 완료되기 전에 동일한 인스턴스에 대해 두 번 이상 호출 OpenAsync(CancellationToken) 합니다.

Context Connection=true 연결 문자열 지정됩니다.

연결 시간이 경과하기 전에 연결 풀에서 연결을 사용할 수 없습니다.

SqlException

연결을 여는 동안 발생한 SQL Server 반환된 모든 오류입니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

호출 OpenAsyncState 한 후 반환된 작업이 완료될 때까지 반환 ConnectingTask 해야 합니다. 그런 다음 연결에 성공한 State 경우 .Open 연결이 실패하면 .를 State 반환 Closed해야 합니다.

호출은 Close 해당 OpenAsync 호출을 취소하거나 닫으려고 시도합니다.

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

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 Open()throw된 예외를 참조하세요.

적용 대상

추가 정보