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
継承階層
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 クラス