Поделиться через

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>

Возвращает задачу, которая предоставляет новый экземпляр службы.

Комментарии

Этот метод гарантированно вызывается из потока пользовательского интерфейса и только для поставщиков, возвращающих значение true из IsAuthenticated , если реализован connectedServiceAuthenticator.

Если реализация хочет представить блокирующий или модальный пользовательский интерфейс, она может сделать это. Если экземпляр службы создается синхронно перед возвратом метода, возвращаемая задача должна быть помечена как завершенная (скорее всего, с помощью Task.FromResult()).

Если реализация выполняется в фоновом режиме, она может вернуть выполняющиеся задачи, и код подключенных служб обновит пользовательский интерфейс после завершения задачи. В этом случае код подключенных служб может отменить задачу с помощью CancellationToken, если пользователь закрывает пользовательский интерфейс conencted Services до создания экземпляра.

Если реализация не отслеживает или не может отслеживать создание нового экземпляра, она может вернуть значение NULL. В этом случае код подключенных служб не будет делать никаких действий и требует, чтобы пользователь вручную обновил или перечислил экземпляры службы, чтобы проверка для вновь созданного экземпляра.

Если в реализации отображаются или обрабатываются какие-либо ошибки, задача не должна выполнять их ошибку и не выдавать их как исключения. Если возвращенная задача завершается в состоянии Сбоя (так, что член исключения не равен NULL), пользовательский интерфейс подключенных служб сообщит пользователю о сбое.

Применяется к