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

CancelToken 用來取消建立作業。

傳回

Task<ConnectedServiceInstance>

傳回提供新服務實例的工作。

備註

此方法保證會從 UI 線程呼叫，而且只有在實作 ConnectedServiceAuthenticator 時，才會在 IsAuthenticated 傳回 'true' 的提供者上呼叫。

如果實作想要呈現封鎖/強制回應UI，它可能會這麼做。 如果在方法傳回之前同步建立服務實例，則傳回的工作應該標示為已完成， (可能透過Task.FromResult () ) 。

如果實作在背景執行，它可能會傳回進行中的工作，且連線服務程序代碼會在工作完成之後重新整理UI。 在此情況下，如果使用者在建立實例之前關閉 Conencted Services UI，連線服務程式代碼可能會透過 CancellationToken 取消工作。

如果實作沒有或無法監視新實例的建立，它可能會傳回 null。 在此情況下，連線服務程式代碼不會執行任何動作，而且會要求使用者手動重新整理/列舉服務實例，以檢查新建立的實例。

如果實作顯示/處理任何錯誤，工作就不應該發生錯誤，也不會將它們擲回為例外狀況。 如果傳回的工作在錯誤狀態 (完成，讓例外狀況成員為非 Null，) 連線服務 UI 會通知用戶失敗。