WebRequestHandler::CachePolicy Property

.NET Framework (current version)

Gets or sets the cache policy for this request.

Namespace:   System.Net.Http
Assembly:  System.Net.Http.WebRequest (in System.Net.Http.WebRequest.dll)

property RequestCachePolicy^ CachePolicy {
	RequestCachePolicy^ get();
	void set(RequestCachePolicy^ value);

Property Value

Type: System.Net.Cache::RequestCachePolicy^

Returns RequestCachePolicy.

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.

.NET Framework
Available since 4.5
Return to top