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

Статья
08/11/2011

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

<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-кэширования, и описывает политику кэширования по умолчанию.

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

Указывает, активна ли функция HTTP-кэширования, и описывает политику кэширования по умолчанию.

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

Указывает, активна ли функция FTP-кэширования, и описывает политику кэширования по умолчанию.

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

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

Пример

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

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

См. также

Ссылки

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

System.Net.Cache

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