Поделиться через


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

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

<configuration>   <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>

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

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

Attributes

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

Атрибут policyLevel

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

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

Элемент Description
defaultHttpCachePolicy Необязательный элемент.

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

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

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

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

Example

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

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

См. также