DbConnection.OpenAsync 메서드

정의

이 메서드는 Open()의 비동기 버전을 구현합니다.This method implements an asynchronous version of Open().

오버로드

OpenAsync()

Open()으로 지정된 설정을 사용하여 데이터베이스 연결을 여는 ConnectionString의 비동기 버전입니다.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. 이 메서드는 CancellationToken.None을 사용하여 가상 메서드 OpenAsync(CancellationToken)를 호출합니다.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

OpenAsync(CancellationToken)

Open()의 비동기 버전입니다.This is the asynchronous version of Open(). 공급자는 적절한 구현을 재정의해야 합니다.Providers should override with an appropriate implementation. 취소 토큰은 선택적으로 적용될 수 있습니다.The cancellation token can optionally be honored.

기본 구현은 동기 Open() 호출을 호출하고 완료된 작업을 반환합니다.The default implementation invokes the synchronous Open() call and returns a completed task. 기본 구현은 이미 취소된 cancellationToken을 전달하는 경우 취소된 작업을 반환합니다.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Open에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.Exceptions thrown by Open will be communicated via the returned Task Exception property.

반환된 작업이 완료될 때까지 DbConnection 개체의 다른 메서드 및 속성을 호출하지 마십시오.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

설명

SQL Server에 대 한 .NET Framework Data Provider의 비동기 프로그래밍에 대 한 자세한 내용은 비동기 프로그래밍을 참조 하세요.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

OpenAsync()

Open()으로 지정된 설정을 사용하여 데이터베이스 연결을 여는 ConnectionString의 비동기 버전입니다.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. 이 메서드는 CancellationToken.None을 사용하여 가상 메서드 OpenAsync(CancellationToken)를 호출합니다.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

public:
 System::Threading::Tasks::Task ^ OpenAsync();
public System.Threading.Tasks.Task OpenAsync ();
member this.OpenAsync : unit -> System.Threading.Tasks.Task
Public Function OpenAsync () As Task

반환

Task

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

설명

를 호출한 후 OpenAsync 에는 State 반환 된 Connecting 이 완료 될 때까지이 반환 되어야 합니다 Task .After calling OpenAsync, State must return Connecting until the returned Task is completed. 연결에 성공한 경우에는를 State 반환 해야 Open 합니다.Then, if the connection was successful, State must return Open. 연결에 실패 하면는를 State 반환 해야 Closed 합니다.If the connection fails, State must return Closed.

에 대 한 호출은 Close 해당 호출을 취소 하거나 종결 하려고 시도 OpenAsync 합니다.A call to Close will attempt to cancel or close the corresponding OpenAsync call.

SQL Server에 대 한 .NET Framework Data Provider의 비동기 프로그래밍에 대 한 자세한 내용은 비동기 프로그래밍을 참조 하세요.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

적용 대상

OpenAsync(CancellationToken)

Open()의 비동기 버전입니다.This is the asynchronous version of Open(). 공급자는 적절한 구현을 재정의해야 합니다.Providers should override with an appropriate implementation. 취소 토큰은 선택적으로 적용될 수 있습니다.The cancellation token can optionally be honored.

기본 구현은 동기 Open() 호출을 호출하고 완료된 작업을 반환합니다.The default implementation invokes the synchronous Open() call and returns a completed task. 기본 구현은 이미 취소된 cancellationToken을 전달하는 경우 취소된 작업을 반환합니다.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Open에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.Exceptions thrown by Open will be communicated via the returned Task Exception property.

반환된 작업이 완료될 때까지 DbConnection 개체의 다른 메서드 및 속성을 호출하지 마십시오.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

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

매개 변수

cancellationToken
CancellationToken

취소 명령입니다.The cancellation instruction.

반환

Task

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

설명

를 호출한 후 OpenAsync 에는 State 반환 된 Connecting 이 완료 될 때까지이 반환 되어야 합니다 Task .After calling OpenAsync, State must return Connecting until the returned Task is completed. 연결에 성공한 경우에는를 State 반환 해야 Open 합니다.Then, if the connection was successful, State must return Open. 연결에 실패 하면는를 State 반환 해야 Closed 합니다.If the connection fails, State must return Closed.

에 대 한 호출은 Close 해당 호출을 취소 하거나 종결 하려고 시도 OpenAsync 합니다.A call to Close will attempt to cancel or close the corresponding OpenAsync call.

SQL Server에 대 한 .NET Framework Data Provider의 비동기 프로그래밍에 대 한 자세한 내용은 비동기 프로그래밍을 참조 하세요.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

적용 대상