ConnectedServiceGrid.EnumerateServiceInstancesAsync(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.
Ruft eine Liste aller Dienstinstanzen für den aktuell authentifizierten Benutzer ab, sofern vorhanden.
public:
abstract System::Threading::Tasks::Task<System::Collections::Generic::IEnumerable<Microsoft::VisualStudio::ConnectedServices::ConnectedServiceInstance ^> ^> ^ EnumerateServiceInstancesAsync(System::Threading::CancellationToken ct);public abstract System.Threading.Tasks.Task<System.Collections.Generic.IEnumerable<Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance>> EnumerateServiceInstancesAsync(System.Threading.CancellationToken ct);abstract member EnumerateServiceInstancesAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<seq<Microsoft.VisualStudio.ConnectedServices.ConnectedServiceInstance>>Public MustOverride Function EnumerateServiceInstancesAsync (ct As CancellationToken) As Task(Of IEnumerable(Of ConnectedServiceInstance))Parameter
CancellationToken wird verwendet, um den Enumerationsvorgang abzubrechen.
Gibt zurück
Gibt einen Task zurück, der die verfügbaren Dienstinstanzen bereitstellt.
Hinweise
Diese Methode wird garantiert nicht über den UI-Thread aufgerufen. Es wird nur für Anbieter aufgerufen, die "true" von IsAuthenticated zurückgeben, wenn ein ConnectedServiceAuthenticator implementiert ist.
Der Task der Implementierung sollte erst abgeschlossen werden, wenn der Dienst instance Enumerable vollständig verfügbar ist. Der Code für verbundene Dienste aktualisiert die Benutzeroberfläche, sobald der zurückgegebene Task abgeschlossen ist, und die Enumeration sollte bei Netzwerkaufrufen nicht blockiert werden.
Da dies im UI-Thread nicht aufgerufen wird, sollte die Implementierung keine Fehler anzeigen. Falls erforderlich, sollte der Task im Status Fehler abgeschlossen werden (sodass der Ausnahmemember ungleich NULL ist), und die Benutzeroberfläche für verbundene Dienste informiert den Benutzer über den Fehler.