ConnectedServiceGrid.CreateServiceInstanceAsync(CancellationToken) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Crie uma nova instância do serviço.
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)Parâmetros
CancellationToken usado para cancelar a operação de criação.
Retornos
Retorna uma Tarefa que fornece a nova instância de serviço.
Comentários
Esse método tem a garantia de ser chamado do thread da interface do usuário e somente em provedores que retornam "true" de IsAuthenticated se um ConnectedServiceAuthenticator for implementado.
Se uma implementação quiser apresentar a interface do usuário de bloqueio/modal, ela poderá fazer isso. Se a instância de serviço for criada de forma síncrona antes que o método retorne, a Tarefa retornada deverá ser marcada como concluída (provavelmente por meio de Task.FromResult()).
Se a implementação for executada em segundo plano, ela poderá retornar uma Tarefa em andamento e o código dos Serviços Conectados atualizará a interface do usuário assim que a Tarefa for concluída. Nesse caso, o código dos Serviços Conectados poderá cancelar a tarefa por meio do CancellationToken se o usuário fechar a interface do usuário do Conencted Services antes da instância ter sido criada.
Se a implementação não fizer ou não puder monitorar a criação da nova instância, ela poderá retornar nulo. Nesse caso, o código dos Serviços Conectados não fará nada e exige que o usuário atualize/enumere manualmente as instâncias de serviço para marcar para a instância recém-criada.
Se a implementação mostrar/manipular erros, a Tarefa não deverá falhar neles nem gerá-los como Exceções. Se a Tarefa retornada for concluída em um estado com falha (de modo que o membro Exception não seja nulo), a interface do usuário dos Serviços Conectados informará o usuário sobre a falha.