This documentation is archived and is not being maintained.

IssuedTokenClientCredential.IssuedTokenRenewalThresholdPercentage Property

Gets or sets the renewal threshold percentage for issued tokens.

Namespace:  System.ServiceModel.Security
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public int IssuedTokenRenewalThresholdPercentage { get; set; }

Property Value

Type: System.Int32
The renewal threshold percentage for issued tokens. The default value is 60.

ExceptionCondition
InvalidOperationException

An attempt was made to set a read-only credential.

The client caches issued tokens and when a cached issued token is going to expire in the near future, the client automatically gets a fresh issued token from the Security Token Service. The value of this property determines what percentage of the cached issued token's validity period must be over before getting a fresh issued token.

For example, if this property's value is 60, and the client gets an issued token that is valid for 100 minutes, it reuses the cached issued token for 60 minutes, after which it gets a fresh issued token from the Security Token Service.

This code shows how to set this property.


itcc.IssuedTokenRenewalThresholdPercentage = 80;


.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.
Show: