ConnectedServiceGrid.CreateServiceInstanceAsync(CancellationToken) 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.
Créez une nouvelle instance de service.
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)Paramètres
CancellationToken utilisé pour annuler l’opération de création.
Retours
Retourne une tâche qui fournit le nouveau service 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 créé de manière synchrone avant le retour de la méthode, la tâche retournée doit être marquée comme terminée (probablement 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 création de la nouvelle instance, elle peut retourner la valeur 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 le instance nouvellement créé.
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.