DbConnection.OpenAsync 方法

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

此方法实现 Open() 的异步版本。

重载

OpenAsync()	Open()的异步版本，打开由 ConnectionString指定的设置的数据库连接。 此方法通过 CancellationToken.None 调用虚拟方法 OpenAsync(CancellationToken)。
OpenAsync(CancellationToken)	这是 Open() 的异步版本。 提供程序应使用合适的实现进行重写。 可选择性接受取消标记。 默认实现调用同步 Open() 调用并返回已完成任务。 如果传递到已取消的取消标记，则默认实现将返回已取消的 cancellationToken。 Open 引发的异常将通过返回的任务异常属性传递。 在返回的任务完成前，不要调用 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

表示异步操作的任务。

注解

调用 OpenAsync后， State 必须返回 Connecting ，直到返回的 Task 完成。 然后，如果连接成功， State 则必须返回 Open。 如果连接失败， State 必须返回 Closed。

对 的 Close 调用将尝试取消或关闭相应的 OpenAsync 调用。

有关 SQL Server .NET Framework 数据提供程序中的异步编程的详细信息，请参阅异步编程。

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 Open()异常。

另请参阅

• ADO.NET 概述

OpenAsync(CancellationToken)

Source:

DbConnection.cs

这是 Open() 的异步版本。 提供程序应使用合适的实现进行重写。 可选择性接受取消标记。

默认实现调用同步 Open() 调用并返回已完成任务。 如果传递到已取消的取消标记，则默认实现将返回已取消的 cancellationToken。 Open 引发的异常将通过返回的任务异常属性传递。

在返回的任务完成前，不要调用 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

表示异步操作的任务。

例外

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

调用 OpenAsync后， State 必须返回 Connecting ，直到返回的 Task 完成。 然后，如果连接成功， State 则必须返回 Open。 如果连接失败， State 必须返回 Closed。

对 的 Close 调用将尝试取消或关闭相应的 OpenAsync 调用。

有关 SQL Server .NET Framework 数据提供程序中的异步编程的详细信息，请参阅异步编程。

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中，则在等待任务时将引发该异常。 使用异常（如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅 引发的 Open()异常。

另请参阅

• ADO.NET 概述