This documentation is archived and is not being maintained.

SecurityTokenProvider.RenewTokenCore Method

Renews a security token.

Namespace:  System.IdentityModel.Selectors
Assembly:  System.IdentityModel (in System.IdentityModel.dll)

protected virtual SecurityToken RenewTokenCore(
	TimeSpan timeout,
	SecurityToken tokenToBeRenewed


Type: System.TimeSpan
A TimeSpan that specifies the timeout value for the message that renews the security token.
Type: System.IdentityModel.Tokens.SecurityToken
The SecurityToken to renew.

Return Value

Type: System.IdentityModel.Tokens.SecurityToken
The SecurityToken that represents the security token that is renewed.

An issued security token that is renewable allows a client to renew it when the security token is about to or has expired.

When the RenewTokenCore method is overridden and the security token passed into the token parameter cannot be renewed, throw the SecurityTokenException exception.

The RenewToken method calls the RenewTokenCore method.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.