RequestCachePolicy Constructor (RequestCacheLevel)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Initializes a new instance of the RequestCachePolicy class. using the specified cache policy.

Namespace:   System.Net.Cache
Assembly:  System (in System.dll)

public RequestCachePolicy(
	RequestCacheLevel level


Type: System.Net.Cache.RequestCacheLevel

A RequestCacheLevel that specifies the cache behavior for resources obtained using WebRequest objects.

Exception Condition

level is not a valid RequestCacheLevel.value.

This constructor initializes the Level property to level.

The RequestCacheLevel value controls whether caching is enabled, and when the cache can be used. For additional information, see the RequestCacheLevel documentation.

The following code example creates a policy with Level set to CacheOnly.and uses it to set the cache policy of a WebRequest.

public static WebResponse GetResponseFromCache(Uri uri)
     RequestCachePolicy policy = 
        new  RequestCachePolicy( RequestCacheLevel.CacheOnly);
    WebRequest request = WebRequest.Create(uri);
    request.CachePolicy = policy;
    WebResponse response = request.GetResponse();
    Console.WriteLine("Policy level is {0}.", policy.Level.ToString());
    Console.WriteLine("Is the response from the cache? {0}", response.IsFromCache);  
    return response;


.NET Framework
Available since 2.0
Return to top