DbConnection.ChangeDatabaseAsync(String, CancellationToken) 메서드

정의

네임스페이스:

System.Data.Common

어셈블리:

System.Data.Common.dll

Source:

DbConnection.cs

열려 있는 연결의 현재 데이터베이스를 비동기적으로 변경합니다.

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.Task

Public Overridable Function ChangeDatabaseAsync (databaseName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

databaseName

String

사용할 연결의 데이터베이스 이름입니다.

cancellationToken

CancellationToken

비동기 작업을 취소하기 위한 선택적 토큰입니다. 기본값은 None입니다.

반환

Task

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

예외

OperationCanceledException

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

설명

매개 변수에 databaseName 제공된 값은 현재 instance 유효한 데이터베이스 이름이어야 합니다.

이 비동기 메서드의 기본 구현은 동기 메서드에 대리하고 호출 스레드를 차단할 수 있는 완료된 Task를 반환합니다.

비동기 프로그래밍을 지원하는 데이터 공급자는 비동기 I/O 작업을 사용하여 기본 구현을 재정의해야 합니다.

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