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

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

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

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

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

Атрибуты

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

Атрибут policyLevel

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

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

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

defaultHttpCachePolicy

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

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

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

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

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

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

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

Пример

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

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

См. также

Ссылки

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

System.Net.Cache

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