ConnectedServiceGrid.CreateServiceInstanceAsync(CancellationToken) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Create una nuova istanza del servizio.
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)Parametri
CancellationToken utilizzato per annullare l'operazione di creazione.
Restituisce
Restituisce un'attività che fornisce la nuova istanza del servizio.
Commenti
Questo metodo è garantito che venga chiamato dal thread dell'interfaccia utente e solo sui provider che restituiscono "true" da IsAuthenticated se viene implementato un connectedServiceAuthenticator.
Se un'implementazione desidera presentare l'interfaccia utente di blocco/modale, può farlo. Se l'istanza del servizio viene creata in modo sincrono prima che il metodo venga restituito, l'attività restituita deve essere contrassegnata come completata (probabilmente tramite Task.FromResult()).
Se l'implementazione viene eseguita in background, può restituire un'attività in corso e il codice di Servizi connessi aggiornerà l'interfaccia utente al termine dell'attività. In questo caso, il codice di Servizi connessi può annullare l'attività tramite CancellationToken se l'utente chiude l'interfaccia utente dei servizi conencted prima della creazione dell'istanza.
Se l'implementazione non esegue o non può monitorare la creazione della nuova istanza, può restituire Null. In questo caso, il codice di Servizi connessi non esegue alcuna operazione e richiede all'utente di aggiornare/enumerare manualmente le istanze del servizio per verificare la presenza dell'istanza appena creata.
Se l'implementazione mostra/gestisce eventuali errori, l'attività non deve generarli come eccezioni. Se l'attività restituita viene completata in uno stato Faulted (in modo che il membro Exception sia diverso da Null) l'interfaccia utente di Servizi connessi informerà l'utente dell'errore.