WebRequestHandler.CachePolicy Property


Gets or sets the cache policy for this request.

 property System::Net::Cache::RequestCachePolicy ^ CachePolicy { System::Net::Cache::RequestCachePolicy ^ get(); void set(System::Net::Cache::RequestCachePolicy ^ value); };
public System.Net.Cache.RequestCachePolicy CachePolicy { get; set; }
member this.CachePolicy : System.Net.Cache.RequestCachePolicy with get, set
Public Property CachePolicy As RequestCachePolicy

Property Value

A RequestCachePolicy object that defines a cache policy. The default is DefaultCachePolicy.


The current cache policy and the presence of the requested resource in the cache determine whether a response can be retrieved from the cache. Using cached responses usually improves application performance, but there is a risk that the response in the cache does not match the response on the server.

The default cache policy can be specified in the Machine.config configuration file or by setting the DefaultCachePolicy property.

A copy of a resource is only added to the cache if the response stream for the resource is retrieved and read to the end of the stream. So another request for the same resource could use a cached copy, depending on the cache policy level for this request.

Applies to