<Элемент 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>
См. также раздел
Совместная работа с нами на GitHub
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.