SecurityTokenProvider.GetTokenAsync(TimeSpan) Método

Definición

Espacio de nombres:

System.IdentityModel.Selectors

Ensamblado:

System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v6.2.0

Source:

SecurityTokenProvider.cs

Obtiene un token de seguridad.

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)

Parámetros

timeout

TimeSpan

TimeSpan que especifica el valor de tiempo de espera para el mensaje que obtiene el token de seguridad.

Devoluciones

Task<SecurityToken>

Task que representa la operación de lectura asincrónica y ajusta el SecurityToken que representa el token de seguridad que se va a obtener.

Comentarios

La clase GetTokenAsync que llama al método ClientCredentials cuando un cliente envía un mensaje SOAP y se requiere un token de seguridad.

El método GetTokenAsync llama al método GetTokenCoreAsync.

En la mayoría de los casos las clases derivadas de timeout como SecurityTokenProvider no utilizan el parámetro UserNameSecurityTokenProvider. Sin embargo, a veces recuperar un token de seguridad implica un marco de mensajería distribuida. IssuedSecurityTokenProvider cuando se usa en un servicio aliado es un ejemplo. En estos casos el parámetro timeout se utiliza para evitar excepciones producidas por errores de la red, pérdida de mensajes y otras condiciones de error.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por GetToken(TimeSpan).