ConnectedServiceGrid.ConfigureServiceInstanceAsync 方法

定義

命名空間:

Microsoft.VisualStudio.ConnectedServices

組件:

Microsoft.VisualStudio.ConnectedServices.dll

套件:

Microsoft.VisualStudio.ConnectedServices v16.2.45

透過對話框或連結至設定網頁來設定服務實例。

public:
 virtual System::Threading::Tasks::Task<bool> ^ ConfigureServiceInstanceAsync(Microsoft::VisualStudio::ConnectedServices::ConnectedServiceInstance ^ instance, System::Threading::CancellationToken ct);

public virtual System.Threading.Tasks.Task<bool> ConfigureServiceInstanceAsync(Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance instance, System.Threading.CancellationToken ct);

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

Public Overridable Function ConfigureServiceInstanceAsync (instance As ConnectedServiceInstance, ct As CancellationToken) As Task(Of Boolean)

參數

instance

ConnectedServiceInstance

要設定的服務實例。

ct

CancellationToken

CancelToken 用來取消組態作業。

傳回

Task<Boolean>

傳回組態的工作。 工作的結果值會指出實例是否有任何變更。

備註

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

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

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

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

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