ConnectedServiceGrid.ConfigureServiceInstanceAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Настройте экземпляр службы с помощью диалогового окна или ссылки на веб-страницу настройки.
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
Экземпляр службы для настройки.
CancellationToken, используемый для отмены операции настройки.
Возвращаемое значение
Возвращает задачу для конфигурации. Значение результата задачи указывает, были ли внесены какие-либо изменения в экземпляр.
Комментарии
Этот метод гарантированно вызывается из потока пользовательского интерфейса и только для поставщиков, возвращающих значение true из IsAuthenticated , если реализован connectedServiceAuthenticator.
Если реализация хочет представить блокирующий или модальный пользовательский интерфейс, она может сделать это. Если экземпляр службы настроен синхронно перед возвратом метода, возвращаемая задача должна быть помечена как завершенная (например, с помощью Task.FromResult()).
Если реализация выполняется в фоновом режиме, она может вернуть выполняющиеся задачи, и код подключенных служб обновит пользовательский интерфейс после завершения задачи. В этом случае код подключенных служб может отменить задачу с помощью CancellationToken, если пользователь закрывает пользовательский интерфейс conencted Services до создания экземпляра.
Если реализация не отслеживает или не может отслеживать конфигурацию экземпляра, она может возвращать значение NULL. В этом случае код подключенных служб не будет делать никаких действий и требует, чтобы пользователь вручную обновил или перечислил экземпляры службы, чтобы проверка изменения настроенного экземпляра.
Если в реализации отображаются или обрабатываются какие-либо ошибки, задача не должна выполнять их ошибку и не выдавать их как исключения. Если возвращенная задача завершается в состоянии Сбоя (так, что член исключения не равен NULL), пользовательский интерфейс подключенных служб сообщит пользователю о сбое.