DbConnection.OpenAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
此方法实现异步 Open()版本的 .
重载
| 名称 | 说明 |
|---|---|
| OpenAsync() |
异步版本的 |
| OpenAsync(CancellationToken) |
这是 .的 Open()异步版本。 提供程序应使用适当的实现替代。 可以选择遵循取消令牌。 默认实现调用同步 Open() 调用并返回已完成的任务。 如果传递已取消的 cancellationToken，则默认实现将返回已取消的任务。 Open 引发的异常将通过返回的任务异常属性进行通信。 在返回的任务完成之前，请勿调用对象的其他方法和属性 |
注解
有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。
OpenAsync()
异步版本的
public:
System::Threading::Tasks::Task ^ OpenAsync();public System.Threading.Tasks.Task OpenAsync();member this.OpenAsync : unit -> System.Threading.Tasks.TaskPublic Function OpenAsync () As Task返回
表示异步操作的任务。
注解
调用 OpenAsync后， State 必须返回 Connecting ，直到返回 Task 的完成。 然后，如果连接成功， State 则必须返回 Open。 如果连接失败， State 则必须返回 Closed。
调用 Close 将尝试取消或关闭相应的 OpenAsync 调用。
有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用情况异常（例如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅由 Open()..
另请参阅
适用于
OpenAsync(CancellationToken)
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.TaskPublic Overridable Function OpenAsync (cancellationToken As CancellationToken) As Task参数
- cancellationToken
- CancellationToken
取消指令。
返回
表示异步操作的任务。
例外
取消令牌已取消。 此异常存储在返回的任务中。
注解
调用 OpenAsync后， State 必须返回 Connecting ，直到返回 Task 的完成。 然后，如果连接成功， State 则必须返回 Open。 如果连接失败， State 则必须返回 Closed。
调用 Close 将尝试取消或关闭相应的 OpenAsync 调用。
有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用情况异常（例如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅由 Open()..