DbConnection.OpenAsync 메서드

정의

네임스페이스:

System.Data.Common

어셈블리:

System.Data.Common.dll

이 메서드는 Open()의 비동기 버전을 구현합니다.

오버로드

OpenAsync()	Open()으로 지정된 설정을 사용하여 데이터베이스 연결을 여는 ConnectionString의 비동기 버전입니다. 이 메서드는 CancellationToken.None을 사용하여 가상 메서드 OpenAsync(CancellationToken)를 호출합니다.
OpenAsync(CancellationToken)	Open()의 비동기 버전입니다. 공급자는 적절한 구현을 재정의해야 합니다. 취소 토큰은 선택적으로 적용될 수 있습니다. 기본 구현은 동기 Open() 호출을 호출하고 완료된 작업을 반환합니다. 기본 구현은 이미 취소된 cancellationToken을 전달하는 경우 취소된 작업을 반환합니다. Open에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다. 반환된 작업이 완료될 때까지 DbConnection 개체의 다른 메서드 및 속성을 호출하지 마십시오.

설명

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

OpenAsync()

Source:

DbConnection.cs

Open()으로 지정된 설정을 사용하여 데이터베이스 연결을 여는 ConnectionString의 비동기 버전입니다. 이 메서드는 CancellationToken.None을 사용하여 가상 메서드 OpenAsync(CancellationToken)를 호출합니다.

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)입니다.

설명

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

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

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

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

추가 정보

• ADO.NET 개요

OpenAsync(CancellationToken)

Source:

DbConnection.cs

Open()의 비동기 버전입니다. 공급자는 적절한 구현을 재정의해야 합니다. 취소 토큰은 선택적으로 적용될 수 있습니다.

기본 구현은 동기 Open() 호출을 호출하고 완료된 작업을 반환합니다. 기본 구현은 이미 취소된 cancellationToken을 전달하는 경우 취소된 작업을 반환합니다. Open에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.

반환된 작업이 완료될 때까지 DbConnection 개체의 다른 메서드 및 속성을 호출하지 마십시오.

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

취소 명령입니다.

반환

Task

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

예외

OperationCanceledException

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

설명

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

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

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

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

추가 정보

• ADO.NET 개요