ConnectedServiceGrid.ConfigureServiceInstanceAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Configurez un service instance par le biais d’une boîte de dialogue ou d’un lien vers la page web de configuration.
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)Paramètres
- instance
- ConnectedServiceInstance
Le service instance à configurer.
CancellationToken utilisé pour annuler l’opération de configuration.
Retours
Retourne une tâche pour la configuration. La valeur de résultat de la tâche indique si des modifications ont été apportées à l’instance.
Remarques
Cette méthode est garantie pour être appelée à partir du thread d’interface utilisateur, et uniquement sur les fournisseurs qui retournent « true » à partir de IsAuthenticated si un ConnectedServiceAuthenticator est implémenté.
Si une implémentation souhaite présenter une interface utilisateur bloquante/modale, elle peut le faire. Si le service instance est configuré de manière synchrone avant le retour de la méthode, la tâche retournée doit être marquée comme terminée (par exemple, via Task.FromResult()).
Si l’implémentation s’exécute en arrière-plan, elle peut retourner une tâche en cours, et le code Des services connectés actualise l’interface utilisateur une fois la tâche terminée. Dans ce cas, le code Connected Services peut annuler la tâche via CancellationToken si l’utilisateur ferme l’interface utilisateur des services conencted avant la création de l’instance.
Si l’implémentation ne surveille pas ou ne peut pas surveiller la configuration de l’instance, elle peut retourner null. Dans ce cas, le code Des services connectés ne fait rien et exige que l’utilisateur actualise/énumère manuellement les instances de service pour case activée pour les modifications apportées à la instance configurée.
Si l’implémentation affiche/gère des erreurs, la tâche ne doit pas les générer d’erreur, ni les lever en tant qu’exceptions. Si la tâche retournée se termine dans un état d’erreur (de sorte que le membre Exception n’est pas null), l’interface utilisateur des services connectés informe l’utilisateur de l’échec.