SecurityTokenProvider.GetTokenAsync(TimeSpan) 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 ein Sicherheitstoken ab.
public:
System::Threading::Tasks::Task<System::IdentityModel::Tokens::SecurityToken ^> ^ GetTokenAsync(TimeSpan timeout);public System.Threading.Tasks.Task<System.IdentityModel.Tokens.SecurityToken> GetTokenAsync(TimeSpan timeout);member this.GetTokenAsync : TimeSpan -> System.Threading.Tasks.Task<System.IdentityModel.Tokens.SecurityToken>Public Function GetTokenAsync (timeout As TimeSpan) As Task(Of SecurityToken)Parameter
- timeout
- TimeSpan
Ein TimeSpan Wert, der den Timeoutwert für die Nachricht angibt, die das Sicherheitstoken abruft.
Gibt zurück
Dies Task stellt den asynchronen Lesevorgang dar und umschließt die SecurityToken , die das abzurufende Sicherheitstoken darstellt.
Hinweise
Die GetTokenAsync Methode wird von der ClientCredentials Klasse aufgerufen, wenn ein Client eine SOAP-Nachricht sendet und ein Sicherheitstoken erforderlich ist.
Die GetTokenAsync Methode ruft die GetTokenCoreAsync Methode auf.
In den meisten Fällen wird der timeout Parameter nicht von abgeleiteten Klassen SecurityTokenProvider wie z UserNameSecurityTokenProvider. B. verwendet. Das Abrufen eines Sicherheitstokens umfasst jedoch manchmal verteilte Nachrichten. Ein Beispiel wird IssuedSecurityTokenProvider in einem Verbunddienst verwendet. In diesen Fällen wird der timeout Parameter verwendet, um Ausnahmen zu vermeiden, die durch Netzwerkfehler, Nachrichtenverlust und andere Fehlerbedingungen verursacht werden.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von GetToken(TimeSpan).
