다음을 통해 공유


SqlConnection.OpenAsync(CancellationToken) 메서드

정의

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

취소 명령입니다.

반환

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

예외

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

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

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

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

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

설명

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

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

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

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

적용 대상

추가 정보