FtpCachePolicySettings Class [IIS 7 and higher]
Represents the default FTP cache policy for network resources.
Syntax
class FtpCachePolicySettings : EmbeddedObject
Methods
This class contains no methods.
Properties
The following table lists the properties exposed by the FtpCachePolicySettings class.
Name |
Description |
|---|---|
PolicyLevel |
A read/write sint32 value that specifies the FTP caching behavior for the local computer. The possible values are listed later in the Remarks section. |
Subclasses
This class contains no subclasses.
Remarks
Instances of this class are contained in the DefaultFtpCachePolicy property of the RequestCachingSection class.
The following table lists the possible values for the PolicyLevel property. The default is 0 (Default).
Value |
Keyword |
Description |
|---|---|---|
0 |
Default |
Satisfies a request for a resource either by using the cached copy of the resource or by sending a request for the resource to the server. The action taken is determined by the current cache policy and the age of the content in the cache. This is the cache level that most applications should use. |
1 |
BypassCache |
Satisfies a request by using the server. No entries are taken from caches, added to caches, or removed from caches between the client and server. This is the default cache behavior specified in the computer configuration file that is included with the .NET Framework. |
2 |
CacheOnly |
Satisfies a request by using the locally cached resource; does not send a request for an item that is not in the cache. When this cache policy level is specified, a WebException exception is thrown if the item is not in the client cache. |
3 |
CacheIfAvailable |
Satisfies a request for a resource from the cache if the resource is available in the cache; otherwise, sends a request for a resource to the server. If the requested item is not available in the local cache, but it is available in a cache between the client and the server, the intermediate cache satisfies the request. |
4 |
Revalidate |
Satisfies a request by using the cached copy of the resource if the time stamp is the same as the time stamp of the resource on the server; otherwise, the resource is downloaded from the server, presented to the caller, and stored in the cache. |
5 |
Reload |
Satisfies a request by using the server. The response might be saved in the cache, depending on the settings of the no-cache and Pragma: no-cache directives in the HTTP caching protocol. |
6 |
NoCacheNoStore |
Never satisfies a request by using resources from the cache, and does not cache resources. If the resource is present in the local cache, it is removed. This policy level indicates to intermediate caches that they should remove the resource. |
Inheritance Hierarchy
FtpCachePolicySettings
Requirements
Type |
Description |
|---|---|
Client |
Requires IIS 7 on Windows Vista. |
Server |
Requires IIS 7 on Windows Server 2008. |
Product |
IIS 7 |
MOF file |
WebAdministration.mof |
See Also
Reference
EmbeddedObject Class [IIS 7 and higher]
RequestCachingSection Class [IIS 7 and higher]