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


Элемент <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>
/>

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

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

Атрибуты

Атрибут

Описание

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>

См. также

Ссылки

Схема параметров сети

System.Net.Cache