ConnectedServiceGrid.CreateServiceInstanceAsync(CancellationToken) 方法

定义

命名空间:

Microsoft.VisualStudio.ConnectedServices

程序集:

Microsoft.VisualStudio.ConnectedServices.dll

包:

Microsoft.VisualStudio.ConnectedServices v16.2.45

创建服务的新实例。

public:
 virtual System::Threading::Tasks::Task<Microsoft::VisualStudio::ConnectedServices::ConnectedServiceInstance ^> ^ CreateServiceInstanceAsync(System::Threading::CancellationToken ct);

public virtual System.Threading.Tasks.Task<Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance> CreateServiceInstanceAsync (System.Threading.CancellationToken ct);

abstract member CreateServiceInstanceAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance>
override this.CreateServiceInstanceAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance>

Public Overridable Function CreateServiceInstanceAsync (ct As CancellationToken) As Task(Of ConnectedServiceInstance)

参数

ct

CancellationToken

CancellationToken 用于取消创建操作。

返回

Task<ConnectedServiceInstance>

返回一个任务，该任务提供新的服务实例。

注解

此方法保证从 UI 线程调用，并且仅在实现 ConnectedServiceAuthenticator 时从 IsAuthenticated 中返回“true”的提供程序上调用。

如果实现想要显示阻止/模式 UI，它可以这样做。 如果在方法返回之前同步创建服务实例，则返回的任务应标记为已完成 (可能通过 Task.FromResult () ) 。

如果实现在后台运行，它可能会返回正在进行的任务，连接服务代码将在任务完成后刷新 UI。 在这种情况下，如果用户在创建实例之前关闭 Conencted Services UI，则连接服务代码可以通过 CancellationToken 取消任务。

如果实现不监视或无法监视新实例的创建，则它可能会返回 null。 在这种情况下，连接的服务代码将不执行任何操作，并要求用户手动刷新/枚举服务实例，以便为新创建的实例检查。

如果实现显示/处理任何错误，则 Task 不应对其出错，也不应将其作为异常引发。 如果返回的任务在错误状态下完成， (异常成员为非空) 连接服务 UI 将通知用户失败。