Класс HttpClientCache

Статья
07/19/2023

Предоставляет конфигурацию кэширования для HTTP-клиента.

Синтаксис

class HttpClientCache : EmbeddedObject

Методы

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

Свойства

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

Имя	Описание
`CacheControlCustom`	Значение для чтения и записи `string` , указывающее заголовок HTTP 1.1 `Cache-Control` для добавления в ответ.
`CacheControlMaxAge`	Значение для чтения и записи `datetime` , указывающее максимальный срок действия элемента управления кэшем HTTP 1.1. Значение по умолчанию — 1 день.
`CacheControlMode`	Перечисление для чтения и записи `sint32` , указывающее режим, используемый для кэширования клиента. Возможные значения перечислены далее в разделе Примечания.
`HttpExpires`	Значение для чтения и записи `string` , указывающее в формате ЗАПРОСА комментариев (RFC) 1123 дату и время, после которого кэшированный ответ считается устаревшим.

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

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

Значение	Ключевое слово	Описание
0	`NoControl`	Не добавляет `Cache-Control` заголовок или `Expires` в ответ.
1	`DisableCache`	Добавляет заголовок `Cache-Control: no-cache` в ответ.
2	`UseMaxAge`	Добавляет заголовок `Cache-Control: max-age=<nnn>` в ответ на основе значения, указанного в свойстве `CacheControlMaxAge` .
3	`UseExpires`	Добавляет заголовок `Expires: <date>` в ответ на основе даты, указанной в свойстве `HttpExpires` .

Дополнительные сведения о полях заголовков см. в статье Запрос комментариев (RFC) 2616, "Протокол передачи гипертекстов — HTTP/1.1".

Дополнительные сведения о форматах даты и времени см. в статье RFC 1123 "Требования к узлам Интернета — приложения и поддержка".

Пример

В следующем примере отображаются свойства класса HttpClientCache .

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Retrieve the static content section.  
Set oSection = oWebAdmin.Get("StaticContentSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Show the path and location.  
WScript.Echo "Path: " & oSection.Path  
WScript.Echo "Location: " & oSection.Location  
WScript.Echo  
  
Display the embedded HttpClientCache properties.  
Set ohttpClientCache = oSection.ClientCache  
WScript.Echo "HttpClientCache properties"  
WScript.Echo "--------------------------"  
WScript.Echo "CacheControlCustom: " & ohttpClientCache.CacheControlCustom  
WScript.Echo "CacheControlMaxAge: " & ohttpClientCache.CacheControlMaxAge  
WScript.Echo "CacheControlMode: " & _  
    GetCacheControlModeText(ohttpClientCache.CacheControlMode)  
WScript.Echo "HttpExpires: " & ohttpClientCache.HttpExpires  
  
' Provide text for CacheControlMode enumeration values.  
Function GetCacheControlModeText(uint32Mode)  
    Select Case uint32Mode  
        Case 0  
            GetCacheControlModeText="NoControl"  
        Case 1  
            GetCacheControlModeText="DisableCache"  
        Case 2  
            GetCacheControlModeText="UseMaxAge"  
        Case 3  
            GetCacheControlModeText="UseExpires"  
        Case Else  
            GetCacheControlModeText="Unknown Mode"  
    End Select  
End Function

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

EmbeddedObject

HttpClientCache

Требования

Тип	Описание
клиент	— 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

См. также:

Класс EmbeddedObject
Класс StaticContentSection
CIM_DATETIME
Метод Datetime.Parse

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