ConnectedServiceGrid.CreateServiceInstanceAsync(CancellationToken) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellen Sie eine neue Instanz des Diensts.
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)Parameter
CancellationToken wird verwendet, um den Erstellungsvorgang abzubrechen.
Gibt zurück
Gibt einen Task zurück, der den neuen Dienst instance bereitstellt.
Hinweise
Diese Methode wird garantiert über den UI-Thread aufgerufen, und nur für Anbieter, die "true" von IsAuthenticated zurückgeben, wenn ein ConnectedServiceAuthenticator implementiert ist.
Wenn eine Implementierung eine blockierende/modale Benutzeroberfläche darstellen möchte, kann sie dies tun. Wenn der Dienst instance synchron erstellt wird, bevor die Methode zurückgegeben wird, sollte der zurückgegebene Task als abgeschlossen gekennzeichnet werden (wahrscheinlich über Task.FromResult()).
Wenn die Implementierung im Hintergrund ausgeführt wird, wird möglicherweise ein gerade ausgeführter Task zurückgegeben, und der Code für verbundene Dienste aktualisiert die Benutzeroberfläche, sobald die Aufgabe abgeschlossen ist. In diesem Fall kann der Code für verbundene Dienste die Aufgabe über CancellationToken abbrechen, wenn der Benutzer die Conencted Services-Benutzeroberfläche schließt, bevor die instance erstellt wurde.
Wenn die Implementierung die Erstellung des neuen instance nicht überwacht oder nicht überwachen kann, gibt sie möglicherweise NULL zurück. In diesem Fall bewirkt der Code für verbundene Dienste nichts und erfordert, dass der Benutzer die Dienstinstanzen manuell aktualisiert/aufzählt, um nach dem neu erstellten instance zu suchen.
Wenn die Implementierung Fehler anzeigt bzw. behandelt, sollte der Task keine Fehler an diesen fehlern und auch nicht als Ausnahmen auslösen. Wenn der zurückgegebene Task in einem Fehlerhaften Zustand abgeschlossen wird (d. h., dass der Ausnahmemember nicht NULL ist), informiert die Benutzeroberfläche für verbundene Dienste den Benutzer über den Fehler.