RequestCachePolicy Constructor (RequestCacheLevel)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com 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
)

Parameters

level
Type: System.Net.Cache.RequestCacheLevel

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

Exception Condition
ArgumentOutOfRangeException

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