SecurityTokenProvider.GetTokenAsync(TimeSpan) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un token di sicurezza.
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)Parametri
- timeout
- TimeSpan
Oggetto TimeSpan che specifica il valore di timeout per il messaggio che ottiene il token di sicurezza.
Valori restituiti
Oggetto Task che rappresenta l'operazione di lettura asincrona ed esegue il wrapping dell'oggetto SecurityToken che rappresenta il token di sicurezza da ottenere.
Commenti
Il GetTokenAsync metodo viene chiamato dalla ClientCredentials classe quando un client invia un messaggio SOAP e è necessario un token di sicurezza.
Il GetTokenAsync metodo chiama il GetTokenCoreAsync metodo .
Nella maggior parte dei casi il timeout parametro non viene usato dalle classi derivate di SecurityTokenProvider , ad esempio UserNameSecurityTokenProvider. Tuttavia, a volte il recupero di un token di sicurezza comporta la messaggistica distribuita. Un esempio viene IssuedSecurityTokenProvider usato in un servizio federato. In questi casi il timeout parametro viene usato per evitare eccezioni causate da errori di rete, perdita di messaggi e altre condizioni di errore.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da GetToken(TimeSpan).
