ConnectedServiceGrid.CreateServiceInstanceAsync(CancellationToken) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Twórca nowe wystąpienie usługi.
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)Parametry
CancellationToken używany do anulowania operacji tworzenia.
Zwraca
Zwraca zadanie, które udostępnia nowe wystąpienie usługi.
Uwagi
Ta metoda ma gwarancję wywołania z wątku interfejsu użytkownika i tylko w przypadku dostawców, którzy zwracają wartość "true" z IsAuthenticated elementu ConnectedServiceAuthenticator.
Jeśli implementacja chce przedstawić interfejs użytkownika blokujący/modalny, może to zrobić. Jeśli wystąpienie usługi jest tworzone synchronicznie przed zwróceniem metody, zwrócone zadanie powinno zostać oznaczone jako ukończone (prawdopodobnie za pośrednictwem Task.FromResult()).
Jeśli implementacja działa w tle, może zwrócić zadanie w toku, a kod połączonych usług odświeży interfejs użytkownika po zakończeniu zadania. W takim przypadku kod usług połączonych może anulować zadanie za pośrednictwem tokenu CancellationToken, jeśli użytkownik zamknie interfejs użytkownika usług połączonych przed utworzeniem wystąpienia.
Jeśli implementacja nie lub nie może monitorować tworzenia nowego wystąpienia, może zwrócić wartość null. W takim przypadku kod usług połączonych nie zrobi nic i wymaga od użytkownika ręcznego odświeżenia/wyliczenia wystąpień usługi w celu sprawdzenia nowo utworzonego wystąpienia.
Jeśli implementacja pokazuje/obsługuje błędy, zadanie nie powinno być na nich błędy ani zgłaszać ich jako wyjątki. Jeśli zwrócone zadanie zostanie ukończone w stanie Błąd (tak, że element członkowski wyjątku jest inny niż null), interfejs użytkownika połączonych usług poinformuje użytkownika o awarii.