HttpCachePolicy.SetMaxAge(TimeSpan) Method

Reference

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Sets the Cache-Control: max-age HTTP header based on the specified time span.

public:
 void SetMaxAge(TimeSpan delta);

public void SetMaxAge(TimeSpan delta);

member this.SetMaxAge : TimeSpan -> unit

Public Sub SetMaxAge (delta As TimeSpan)

Parameters

delta: TimeSpan

The time span used to set the Cache - Control: max-age header.

Exceptions

ArgumentOutOfRangeException

delta is less than 0 or greater than one year.

Examples

The following code example demonstrates how to set the Cache-Control: max-age header to 0 hours, 30 minutes, and 0 seconds.

TimeSpan ts = new TimeSpan(0,30,0);
 Response.Cache.SetMaxAge(ts);

Dim ts As New TimeSpan(0,30,0)
 Response.Cache.SetMaxAge(ts)

Remarks

Max-age is the maximum absolute time a document is allowed to exist before being considered stale.

The SetMaxAge method does not use sliding expiration and will fail if the expiration date violates the principle of restrictiveness.

SetMaxAge is introduced in the .NET Framework version 3.5. For more information, see Versions and Dependencies.

Poznámka

If the SetMaxAge method is called repeatedly, on the second and subsequent calls, the value of the maximum age can only be decreased.

Applies to

Produkt	Verzie
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Zdieľať cez