<Элемент requestCaching> (параметры сети)

Управляет механизмом кэширования для сетевых запросов.

<Конфигурации>
  <system.net>
    <requestCaching>

Синтаксис

<requestCaching  
  isPrivateCache ="true|false"  
  disableAllCaching="true|false"  
  defaultPolicyLevel="BypassCache|Default|CacheOnly|CacheIfAvailable|Revalidate|Reload|NoCacheNoStore|Revalidate"  
  unspecifiedMaximumAge= "d.hh:mm:ss">  
    <defaultHttpCachePolicy>...</defaultHttpCachePolicy>  
    <defaultFtpCachePolicy>...</defaultFtpCachePolicy>  
</requestCaching>

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут Описание
isPrivateCache Указывает, обеспечивает ли кэш изоляцию информации о разных пользователях. Значение по умолчанию — true. Это значение должно быть false для приложений среднего уровня.
disableAllCaching Указывает, что кэширование отключено для всех веб-ответов и не может быть переопределено программным способом.
defaultPolicyLevel Одно из значений в перечислении RequestCacheLevel. Значение по умолчанию — BypassCache.
unspecifiedMaximumAge Указывает время по умолчанию, по истечении которого содержимое помечается как просроченное.

Атрибут policyLevel

Значение Описание
Default Возвращает кэшированный ресурс, если ресурс свежий, длина содержимого точна, а также атрибуты срока действия, изменения и длины содержимого.
BypassCache Возвращает ресурс с сервера.
CacheOnly Возвращает кэшированный ресурс, если длина содержимого присутствует и соответствует размеру записи.
CacheIfAvailable Возвращает кэшированный ресурс, если длина содержимого указана и соответствует размеру записи; В противном случае ресурс загружается с сервера и возвращается вызывающей объекту.
Revalidate Возвращает кэшированный ресурс, если метка времени кэшированного ресурса совпадает с меткой времени ресурса на сервере; в противном случае ресурс загружается с сервера, сохраняется в кэше и возвращается вызывающей объекту.
Reload Скачивает ресурс с сервера, сохраняет его в кэше и возвращает ресурс вызывающему объекту.
NoCacheNoStore Если кэшированный ресурс существует, он удаляется. Ресурс загружается с сервера и возвращается вызывающей объекту.
Revalidate Выполняет запрос, используя кэшированную копию ресурса, если метка времени совпадает с меткой времени ресурса на сервере; в противном случае ресурс загружается с сервера, представляется вызывающей объекту и сохраняется в кэше.

Дочерние элементы

Элемент Описание
defaultHttpCachePolicy Необязательный элемент.

Описывает, активно ли кэширование HTTP, и описывает политику кэширования по умолчанию.
<Элемент defaultFtpCachePolicy> (параметры сети) Необязательный элемент.

Описывает, активно ли кэширование FTP, и описывает политику кэширования по умолчанию.

Родительские элементы

Элемент Описание
system.net Содержит параметры сети, определяющие способ подключения .NET Framework к Интернету.

Пример

В следующем примере показано, как отключить все кэширование.

<configuration>  
  <system.net>  
    <requestCaching  
      disableAllCaching="true"  
    />  
  </system.net>  
</configuration>  

См. также раздел