DbConnection.ChangeDatabaseAsync(String, CancellationToken) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
열려 있는 연결에 대한 현재 데이터베이스를 비동기적으로 변경합니다.
public virtual System.Threading.Tasks.Task ChangeDatabaseAsync(string databaseName, System.Threading.CancellationToken cancellationToken = default);abstract member ChangeDatabaseAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.ChangeDatabaseAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function ChangeDatabaseAsync (databaseName As String, Optional cancellationToken As CancellationToken = Nothing) As Task매개 변수
- databaseName
- String
사용할 연결에 대한 데이터베이스의 이름입니다.
- cancellationToken
- CancellationToken
비동기 작업을 취소하는 선택적 토큰입니다. 기본값은 None입니다.
반품
비동기 작업을 나타내는 작업입니다.
예외
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
매개 변수에 databaseName 제공된 값은 현재 인스턴스의 유효한 데이터베이스 이름이어야 합니다.
이 비동기 메서드의 기본 구현은 동기 메서드에 위임되고 완료된 Task것을 반환하여 호출 스레드를 차단할 수 있습니다.
비동기 프로그래밍을 지원하는 데이터 공급자는 비동기 I/O 작업을 사용하여 기본 구현을 재정의해야 합니다.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 ChangeDatabase(String)throw된 예외를 참조하세요.