Класс RequestCachingSection

Статья
07/18/2023

Содержит сведения о конфигурации для кэширования запросов.

Синтаксис

class RequestCachingSection : ConfigurationSection

Методы

В следующей таблице перечислены методы, предоставляемые классом RequestCachingSection .

Имя	Описание
GetAllowDefinition	(Наследуется от ConfigurationSection.)
GetAllowLocation	(Является наследником `ConfigurationSection`)
RevertToParent	(Является наследником `ConfigurationSection`)
SetAllowDefinition	(Является наследником `ConfigurationSection`)
SetAllowLocation	(Является наследником `ConfigurationSection`)

Свойства

В следующей таблице перечислены свойства, предоставляемые классом RequestCachingSection .

Имя	Описание
`DefaultFtpCachePolicy`	Значение FtpCachePolicySettings , указывающее поведение кэширования FTP по умолчанию для локального компьютера.
`DefaultHttpCachePolicy`	Значение HttpCachePolicySettings , указывающее поведение кэширования HTTP по умолчанию для локального компьютера.
`DefaultPolicyLevel`	Значение для чтения и записи `sint32` , указывающее уровень политики кэша по умолчанию. Возможные значения перечислены далее в разделе Примечания.
`DisableAllCaching`	Значение для чтения и записи `boolean` . Значение `true`, если кэширование отключено на локальном компьютере; в противном случае — `false`. Примечание: Если для этого атрибута конфигурации задано значение `true` в любом файле конфигурации, кэширование отключается глобально, а все остальные параметры, связанные с кэшем, игнорируются.
`IsPrivateCache`	Значение для чтения и записи `boolean` . `true` если кэш локального компьютера является частным (то есть обеспечивает изоляцию пользователей); в противном случае — `false`. Примечание: На клиентских компьютерах это значение обычно равно `true`, что указывает, что один пользователь не может использовать ресурсы, кэшированные другим пользователем. Для приложений среднего уровня это значение обычно имеет значение `false`.
`Location`	(Наследуется от `ConfigurationSection`.) Свойство ключа.
`Path`	(Наследуется от `ConfigurationSection`.) Свойство ключа.
`SectionInformation`	(Является наследником `ConfigurationSection`)
`UnspecifiedMaximumAge`	Значение для чтения и записи `datetime` , указывающее максимальный возраст по умолчанию для кэшированных ресурсов, не имеющих сведений об истечении срока действия. Значение по умолчанию — 1 день. Задание этого свойства гарантирует, что ресурс без сведений о заголовке срока действия не будет оставаться в кэше на неопределенный срок.

используются подклассы ;

Этот класс не содержит подклассов.

Значение	Ключевое слово	Описание
0	`Default`	Выполняет запрос ресурса с помощью кэшированной копии ресурса или путем отправки запроса ресурса на сервер. Выполняемое действие определяется текущей политикой кэша и временем существования содержимого кэша. Большинство приложений должны использовать этот уровень кэша.
1	`BypassCache`	Выполняет запрос, используя сервер. Записи не берутся из кэшей, не добавляются в кэши и не удаляются из кэшей между клиентом и сервером. Это поведение кэша по умолчанию, указанное в файле конфигурации компьютера, который входит в состав платформа .NET Framework.
2	`CacheOnly`	Выполняет запрос с помощью локально кэшированного ресурса; не отправляет запрос на элемент, который отсутствует в кэше. Если указан этот уровень политики кэша, создается исключение WebException , если элемент не находится в кэше клиента.
3	`CacheIfAvailable`	Выполняет запрос ресурса из кэша, если ресурс доступен, в противном случае отправляет запрос ресурса на сервер. Если запрошенный элемент недоступен в локальном кэше, но доступен в кэше между клиентом и сервером, промежуточный кэш удовлетворяет запросу.
4	`Revalidate`	Выполняет запрос, используя кэшированную копию ресурса, если метка времени совпадает с меткой времени ресурса на сервере; В противном случае ресурс загружается с сервера, представляется вызывающей объекту и сохраняется в кэше.
5	`Reload`	Выполняет запрос, используя сервер. Ответ может быть сохранен в кэше в зависимости от параметров директивы `no-cache` управления кэшем и заголовка `Pragma: no-cache` в протоколе кэширования HTTP.
6	`NoCacheNoStore`	Никогда не удовлетворяет запросу, используя ресурсы из кэша, и не кэширует ресурсы. Если ресурс есть в локальном кэше, он удаляется. Этот уровень политики указывает, что ресурс должен быть удален из промежуточных кэшей. В протоколе кэширования HTTP это достигается с помощью директивы управления кэшем `no-cache` .

Иерархия наследования

ConfigurationSection

RequestCachingSection

Требования

Тип	Описание
клиент	— IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 на Windows 10
Сервер	— IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016
Продукт	— IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-файл	WebAdministration.mof

См. также:

Класс ConfigurationSection
Класс FtpCachePolicySettings
Класс HttpCachePolicySettings
Перечисление System.Net.Cache.RequestCacheLevel
Класс System.Net.WebException
CIM_DATETIME

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