ConnectedServiceGrid.ConfigureServiceInstanceAsync Metoda

Reference

Definice

Obor názvů:: Microsoft.VisualStudio.ConnectedServices

Sestavení:: Microsoft.VisualStudio.ConnectedServices.dll

Balíček:: Microsoft.VisualStudio.ConnectedServices v16.2.45

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Nakonfigurujte instanci služby prostřednictvím dialogového okna nebo propojením s webovou stránkou konfigurace.

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

Instance služby, která se má nakonfigurovat.

ct: CancellationToken

CancellationToken použitý ke zrušení operace konfigurace.

Návraty

Task<Boolean>

Vrátí úlohu pro konfiguraci. Výsledná hodnota úlohy označuje, jestli byly v instanci provedeny nějaké změny.

Poznámky

Tato metoda je zaručeno, že bude volána z vlákna uživatelského rozhraní a pouze u zprostředkovatelů, kteří vracejí hodnotu true z IsAuthenticated , pokud je implementováno ConnectedServiceAuthenticator.

Pokud implementace chce prezentovat blokující nebo modální uživatelské rozhraní, může to udělat. Pokud je instance služby nakonfigurovaná synchronně před vrácením metody, vrácená úloha by měla být označena jako dokončená (například přes Task.FromResult()).

Pokud implementace běží na pozadí, může vrátit probíhající úlohu a kód Připojených služeb po dokončení úlohy aktualizuje uživatelské rozhraní. V takovém případě může kód připojených služeb zrušit úlohu prostřednictvím CancellationToken, pokud uživatel zavře uživatelské rozhraní propojených služeb před vytvořením instance.

Pokud implementace není nebo nemůže sledovat konfiguraci instance, může vrátit hodnotu null. V takovém případě kód připojených služeb nedělá nic a vyžaduje, aby uživatel ručně aktualizoval nebo vyčíslil instance služby, aby zkontroloval změny nakonfigurované instance.

Pokud implementace zobrazí nebo zpracuje nějaké chyby, úloha by na nich neměla chybovat, ani je vyvolat jako výjimky. Pokud se vrácená úloha dokončí ve stavu Chyba (například, že člen výjimky nemá hodnotu null), uživatelské rozhraní připojených služeb informuje uživatele o selhání.

Platí pro

Sdílet prostřednictvím