ConnectedServiceGrid.ConfigureServiceAsync(CancellationToken) メソッド

定義

名前空間:

Microsoft.VisualStudio.ConnectedServices

アセンブリ:

Microsoft.VisualStudio.ConnectedServices.dll

パッケージ:

Microsoft.VisualStudio.ConnectedServices v16.2.45

ダイアログを使用するか、構成 Web ページにリンクしてサービスを構成します。

public:
 virtual System::Threading::Tasks::Task ^ ConfigureServiceAsync(System::Threading::CancellationToken ct);

public virtual System.Threading.Tasks.Task ConfigureServiceAsync (System.Threading.CancellationToken ct);

abstract member ConfigureServiceAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.ConfigureServiceAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function ConfigureServiceAsync (ct As CancellationToken) As Task

パラメーター

ct

CancellationToken

構成操作を取り消すために使用される CancellationToken。

戻り値

Task

構成のタスクを返します。

注釈

このメソッドは、UI スレッドから呼び出されていることが保証されます。

実装でブロッキング/モーダル UI を表示する必要がある場合は、それを行うことができます。 メソッドが返される前にサービスが同期的に構成されている場合、返される Task は完了としてマークされます (たとえば、Task.FromResult())。

実装がバックグラウンドで実行されている場合は、進行中のタスクが返される可能性があり、タスクが完了すると、Connected Services コードによって UI が更新されます。 この場合、サービスが構成される前にユーザーが Conencted Services UI を閉じると、Connected Services コードによって CancellationToken を介してタスクが取り消されることがあります。

実装でエラーが表示または処理される場合、タスクはエラーを発生させず、例外としてスローしないでください。 返されたタスクが Faulted 状態 (例外メンバーが null 以外) で完了した場合、接続済みサービス UI によってユーザーにエラーが通知されます。