SqlConnection.OpenAsync(CancellationToken) 메서드

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.SqlClient.dll

패키지:

System.Data.SqlClient v4.8.6

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

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

예외

InvalidOperationException

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

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

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

SqlException

연결을 여는 동안 발생한 SQL Server에서 반환되는 오류입니다.

OperationCanceledException

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

설명

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

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

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

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

추가 정보

• ADO.NET 개요