ConnectedServiceGrid.ConfigureServiceAsync(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.
Konfigurieren Sie einen Dienst entweder über ein Dialogfeld oder eine Verknüpfung mit der Webseite konfigurieren.
public:
virtual System::Threading::Tasks::Task ^ ConfigureServiceAsync(System::Threading::CancellationToken ct);public virtual System.Threading.Tasks.Task ConfigureServiceAsync(System.Threading.CancellationToken ct);abstract member ConfigureServiceAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.ConfigureServiceAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function ConfigureServiceAsync (ct As CancellationToken) As TaskParameter
CancellationToken wird verwendet, um den Konfigurationsvorgang abzubrechen.
Gibt zurück
Gibt einen Task für die Konfiguration zurück.
Hinweise
Diese Methode wird garantiert über den UI-Thread aufgerufen.
Wenn eine Implementierung eine blockierende/modale Benutzeroberfläche darstellen möchte, kann sie dies tun. Wenn der Dienst synchron konfiguriert ist, bevor die Methode zurückgibt, sollte der zurückgegebene Task als abgeschlossen gekennzeichnet werden (z. B. ü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 Benutzeroberfläche von Conencted Services schließt, bevor der Dienst konfiguriert wurde.
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.