RequestCachePolicy Class

Definition

Namespace:

System.Net.Cache

Assembly:

System.Net.Primitives.dll

Source:

RequestCachePolicy.cs

Defines an application's caching requirements for resources obtained by using WebRequest objects.

public ref class RequestCachePolicy

public class RequestCachePolicy

type RequestCachePolicy = class

Public Class RequestCachePolicy

Inheritance

Object

RequestCachePolicy

Derived

System.Net.Cache.HttpRequestCachePolicy

Examples

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

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

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;
}

Remarks

You can specify a default cache policy for your application by using the DefaultCachePolicy property or the application or machine configuration files. For more information, see <requestCaching> Element (Network Settings).

You can specify the cache policy for an individual request by using the CachePolicy property.

Caching for Web services is not supported.

Constructors

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

Properties

Level

Gets the RequestCacheLevel value specified when this instance was constructed.

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string representation of this instance.

See also

• Cache Management for Network Applications