ConnectedServiceGrid.ConfigureServiceInstanceAsync 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.
Configure uma instância de serviço por meio de uma caixa de diálogo ou vinculando à página da Web de configuração.
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)Parâmetros
- instance
- ConnectedServiceInstance
A instância de serviço a ser configurada.
CancellationToken usado para cancelar a operação de configuração.
Retornos
Retorna uma Tarefa para a configuração. O valor de resultado da Tarefa indica se alguma alteração foi feita na instância.
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 configurada de forma síncrona antes que o método retorne, a Tarefa retornada deverá ser marcada como concluída (por exemplo, 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 de a instância ter sido criada.
Se a implementação não monitorar ou não a configuração da 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 alterações na instância configurada.
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.