CachingProfileElement クラス

特定の要求の拡張子のキャッシュを構成します。

構文

class CachingProfileElement : CollectionElement  

メソッド

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

プロパティ

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

名前 説明
Duration 応答をキャッシュに保持する時間を指定する読み取り/書き込みの datetime 値。 既定値は 30 秒です。 有効な時間の範囲は 0 から 365 日です。
Extension キャッシュ プロファイルを使用する要求の拡張子を指定する、必須の一意の読み取り/書き込みの string 値。 拡張子の形式は "EXT" または "*" でなければなりません。ここで、EXT は拡張子です。 キー プロパティ。 注: 重複する拡張子エントリは許可されません。 各要求は、正確に 1 つの CachingProfileElement オブジェクトにマップされます。 "*" のエントリが存在する場合、より具体的な拡張子を持つ他のキャッシュ プロファイルにより、アスタリスクを持つプロファイルがオーバーライドされます。 プロファイル エントリの順序は重要ではありません。
KernelCachePolicy カーネル キャッシュ ポリシーを構成する読み取り/書き込みの sint32 値。 使用できる値の一覧は、後述の「注釈」セクションに示します。
Location 出力キャッシュの可能な場所を指定する読み取り/書き込みの sint32 値。 使用できる値の一覧は、後述の「注釈」セクションに示します。
Policy 出力キャッシュ ポリシーを構成する読み取り/書き込みの sint32 値。 使用できる値の一覧は、後述の「注釈」セクションに示します。
VaryByHeaders URL に対するキャッシュされた応答を変更するためにサーバーが使用するヘッダー名のコンマ区切りのリストを含む読み取り/書き込みの string 値。
VaryByQueryString URL に対するキャッシュされた応答を変更するためにサーバーが使用するクエリ文字列パラメーター名のコンマ区切りのリストを含む読み取り/書き込みの string 値。

サブクラス

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

解説

このクラスは、ApplicationHost.config ファイルの <system.webServer/caching> セクションの下にある <profiles> 要素に対応しています。 このクラスのインスタンスは、CachingProfileSettings クラスの Profiles 配列プロパティに含まれています。

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

Value キーワード 説明
0 DontCache 応答はカーネルにキャッシュされません。 ただし、出力キャッシュは引き続き行われる可能性があります。 注: この設定は、Location プロパティ内の競合する設定をオーバーライドします。
1 CacheUntilChange 応答は、エントリが無効にされるか、Duration プロパティで指定された非アクティブ期間が経過して期限切れになるまで、HTTP.SYS キャッシュにキャッシュされます。
2 CacheForTimePeriod 応答は、エントリが途中で無効にされた場合でも、Duration プロパティで指定された時間キャッシュされます。
3 DisableCache キャッシュは無効になり、キャッシュは行われません。

次の表に、Location プロパティとして使用できる値の一覧を示します。 既定値は 3 (Server) です。

Value キーワード 説明
0 Any 応答は、クライアント、Web サーバー、またはプロキシ サーバーでキャッシュできます。
1 Client 応答はクライアントでのみキャッシュされます。
2 Downstream 応答はプロキシ サーバーとクライアントでキャッシュされますが、Web サーバーではキャッシュされません。
3 Server 応答は Web サーバーでのみキャッシュされます。
4 None 応答はどこでもキャッシュされません。
5 ServerAndClient 応答は Web サーバーとクライアントの両方でキャッシュされますが、プロキシ サーバーではキャッシュされません。 注: この設定を使用すると、サーバーのプライベート コンテンツの動作が異なる場合に、プロキシ キャッシュにおいて複数のユーザー間でコンテンツが共有されないようにすることができます。

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

Value キーワード 説明
0 DontCache 応答は出力キャッシュに配置されません。 ただし、カーネル キャッシュは引き続き行われる可能性があります。
1 CacheUntilChange 応答は、エントリが無効にされるか、Duration プロパティで指定された非アクティブ期間が経過して期限切れになるまで、キャッシュされます。
2 CacheForTimePeriod 応答は、エントリが途中で無効にされた場合でも、Duration プロパティで指定された時間キャッシュされます。
3 DisableCache キャッシュは無効になり、キャッシュは行われません。

次の例では、既定の Web サイトのすべての CachingProfileElement オブジェクトを表示します。

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the caching section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "CachingSection", oSection  

' Display the path and location.  
Wscript.Echo "Path: " & oSection.Path  
Wscript.Echo "Location: " & oSection.Location  
Wscript.Echo

' Display all of the caching profiles for the default Web site.  
For Each oCachingProfileElement In oSection.Profiles.Profiles  
    Wscript.Echo
    WScript.Echo "[ " & oCachingProfileElement.Extension & _  
        " ] Caching Profile"  
    WScript.Echo "-----------------------------------"  
    WScript.Echo "Duration: " & oCachingProfileElement.Duration  
    WScript.Echo "KernelCachePolicy: " & _  
        CachePolicyText(oCachingProfileElement.KernelCachePolicy)  
    WScript.Echo "Location: " & _  
        LocationText(oCachingProfileElement.Location)  
    WScript.Echo "Policy: " & _  
        CachePolicyText(oCachingProfileElement.Policy)  
    WScript.Echo "VaryByHeaders: " & _  
        oCachingProfileElement.VaryByHeaders  
    WScript.Echo "VaryByQueryString: " & _  
        oCachingProfileElement.VaryByQueryString  
    WScript.Echo
Next  

' Provide text for KernelCachePolicy and Policy enumeration values.  
Function CachePolicyText(enumval)  

    Select Case enumval  
        Case 0  
            CachePolicyText="DontCache"  
        Case 1  
            CachePolicyText="CacheUntilChange"  
        Case 2  
            CachePolicyText="CacheForTimePeriod"  
        Case 3  
            CachePolicyText="DisableCache"  
        Case Else  
            CachePolicyText="Undefined enumeration value"  
    End Select  

End Function  

' Provide text for Location enumeration values.  
Function LocationText(enumval)  

    Select Case enumval  
        Case 0  
            LocationText="Any"  
        Case 1  
            LocationText="Client"  
        Case 2  
            GetLocationText="Downstream"  
        Case 3  
            LocationText="Server"  
        Case 4  
            LocationText="None"  
        Case 5  
            LocationText="ServerAndClient"  
        Case Else  
            LocationText="Undefined enumeration value"  
    End Select  

End Function

継承階層

CollectionElement

CachingProfileElement

要件

説明
クライアント - 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

参照

AspCache クラス
CachingProfileSettings クラス
CachingSection クラス
CollectionElement クラス
HttpClientCache クラス