HttpClientCache クラス

  • [アーティクル]

HTTP クライアントのキャッシュ構成を公開します。

構文

class HttpClientCache : EmbeddedObject

メソッド

このクラスにはメソッドが含まれていません。

プロパティ

次の表は、HttpClientCache クラスによって公開されるプロパティの一覧です。

名前 説明
CacheControlCustom 応答に追加する HTTP 1.1 Cache-Control ヘッダーを指定する、読み取り/書き込みの string 値。
CacheControlMaxAge HTTP 1.1 キャッシュ コントロールの最大有効期間を指定する、読み取り/書き込みの datetime 値。 既定値は 1 日です。
CacheControlMode クライアント キャッシュに使用するモードを指定する、読み取り/書き込みの sint32 列挙型。 使用できる値の一覧は、後述の「注釈」セクションに示します。
HttpExpires キャッシュされた応答が古いと見なされる日時を Request for Comments (RFC) 1123 形式で指定する、読み取り/書き込みの string 値。

サブクラス

このクラスにはサブクラスが含まれていません。

解説

このクラスのインスタンスは、StaticContentSection クラスの ClientCache 配列プロパティに含まれています。

次の表に、CacheControlMode プロパティとして使用できる値を示します。 既定値は 0 (NoControl) です。

Value キーワード 説明
0 NoControl 応答に Cache-Control ヘッダーも Expires ヘッダーも追加しません。
1 DisableCache Cache-Control: no-cache ヘッダーを応答に追加します。
2 UseMaxAge CacheControlMaxAge プロパティで指定された値に基づいて、応答に Cache-Control: max-age=<nnn> ヘッダーを追加します。
3 UseExpires HttpExpires プロパティで指定された日付に基づいて、応答に Expires: <date> ヘッダーを追加します。

ヘッダー フィールドの詳細については、Request for Comments (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

要件

型 説明
クライアント - Windows Vista 上の IIS 7.0
- Windows 7 上の IIS 7.5
- Windows 8 上の IIS 8.0
- Windows 10 上の IIS 10.0
[サーバー] - Windows Server 2008 上の IIS 7.0
- Windows Server 2008 R2 上の IIS 7.5
- Windows Server 2012 上の IIS 8.0
- Windows Server 2012 R2 上の IIS 8.5
- Windows Server 2016 上の IIS 10.0
Product - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF ファイル WebAdministration.mof

参照

EmbeddedObject クラス
StaticContentSection クラス
CIM_DATETIME
Datetime.Parse メソッド