ConnectedServiceGrid.ConfigureServiceInstanceAsync 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.
Skonfiguruj wystąpienie usługi za pomocą okna dialogowego lub połącz się ze stroną internetową konfigurowania.
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)Parametry
- instance
- ConnectedServiceInstance
Wystąpienie usługi do skonfigurowania.
CancelToken używany do anulowania operacji konfiguracji.
Zwraca
Zwraca zadanie konfiguracji. Wartość wyniku zadania wskazuje, czy wprowadzono jakiekolwiek zmiany w wystąpieniu.
Uwagi
Ta metoda ma być wywoływana z wątku interfejsu użytkownika i tylko dla dostawców, którzy zwracają wartość "true", jeśli IsAuthenticated zaimplementowano moduł ConnectedServiceAuthenticator.
Jeśli implementacja chce przedstawić interfejs użytkownika blokujący/modalny, może to zrobić. Jeśli wystąpienie usługi jest konfigurowane synchronicznie przed zwróceniem metody, zwrócone zadanie powinno zostać oznaczone jako ukończone (na przykład za pośrednictwem Task.FromResult()).
Jeśli implementacja jest uruchamiana 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 połączonych usług może anulować zadanie za pośrednictwem elementu CancelToken, jeśli użytkownik zamknie interfejs użytkownika usług conencted przed utworzeniem wystąpienia.
Jeśli implementacja nie monitoruje konfiguracji wystąpienia lub nie może jej monitorować, może zwrócić wartość null. W takim przypadku kod połączonych usług nie zrobi nic i wymaga od użytkownika ręcznego odświeżenia/wyliczenia wystąpień usługi w celu sprawdzenia zmian w skonfigurowanym wystąpieniu.
Jeśli implementacja pokazuje/obsługuje błędy, zadanie nie powinno być na nich uszkodzone, ani zgłaszać ich jako wyjątki. Jeśli zwrócone zadanie zakończy się w stanie Błędy (tak, że element członkowski wyjątku jest inny niż null), interfejs użytkownika usług połączonych poinformuje użytkownika o niepowodzeniu.