ConnectedServiceGrid.CreateServiceInstanceAsync(CancellationToken) Metoda

Definice

Obor názvů:

Microsoft.VisualStudio.ConnectedServices

Sestavení:

Microsoft.VisualStudio.ConnectedServices.dll

Balíček:

Microsoft.VisualStudio.ConnectedServices v16.2.45

Create novou instanci služby.

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

ct

CancellationToken

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

Návraty

Task<ConnectedServiceInstance>

Vrátí úlohu, která poskytuje novou instanci služby.

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 vytvořena synchronně před vrácením metody, vrácená úloha by měla být označena jako dokončená (pravděpodobně 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 monitorovat vytvoření nové instance, může vrátit 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 nově vytvořenou instanci.

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í.