FtpWebRequest.DefaultCachePolicy Property
Definition
Defines the default cache policy for all FTP requests.
public:
static property System::Net::Cache::RequestCachePolicy ^ DefaultCachePolicy { System::Net::Cache::RequestCachePolicy ^ get(); void set(System::Net::Cache::RequestCachePolicy ^ value); };
public static System.Net.Cache.RequestCachePolicy DefaultCachePolicy { get; set; }
member this.DefaultCachePolicy : System.Net.Cache.RequestCachePolicy with get, set
Public Shared Property DefaultCachePolicy As RequestCachePolicy
Property Value
A RequestCachePolicy that defines the cache policy for FTP requests.
Exceptions
The caller tried to set this property to null
.
Remarks
Only content received using the DownloadFile command is cached.
The following table describes the effects of FTP caching policies on FtpWebRequest.
Policy | Effect |
---|---|
Default | Returns the cached resource if the resource is fresh, the content length is accurate, and the expiration, modification, and content length attributes are present. |
BypassCache | Returns the resource from the server. |
CacheOnly | Returns the cached resource if the content length is present and matches the entry size; otherwise, throws a WebException. |
CacheIfAvailable | Returns the cached resource if the content length is provided and matches the entry size; otherwise, the resource is downloaded from the server and is returned to the caller. |
Revalidate | Returns the cached resource if the timestamp of the cached resource is the same as the time stamp of the resource on the server; otherwise, the resource is downloaded from the server, stored in the cache, and returned to the caller. |
Reload | Downloads the resource from the server, stores it in the cache, and returns the resource to the caller. |
NoCacheNoStore | If a cached resource exists, it is deleted. The resource is downloaded from the server and is returned to the caller. |
Note
Setting DefaultCachePolicy overrides any configuration setting.