ConnectedServiceGrid.ConfigureServiceInstanceAsync 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 instance entweder über ein Dialogfeld oder über eine Verknüpfung mit der Webseite konfigurieren.
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)Parameter
- instance
- ConnectedServiceInstance
Der Zu konfigurierende Dienst instance.
CancellationToken wird verwendet, um den Konfigurationsvorgang abzubrechen.
Gibt zurück
Gibt einen Task für die Konfiguration zurück. Der Ergebniswert des Tasks gibt an, ob Änderungen am instance vorgenommen wurden.
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 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 Conencted Services-Benutzeroberfläche schließt, bevor die instance erstellt wurde.
Wenn die Implementierung die Konfiguration des 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 Änderungen an der konfigurierten 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.