CachingSection クラス
出力とカーネル キャッシュを構成します。
構文
class CachingSection : ConfigurationSectionWithCollection
メソッド
次の表に、CachingSection クラスによって公開されるメソッドの一覧を示します。
| 名前 | 説明 |
|---|---|
| [追加] | (ConfigurationSectionWithCollection から継承。) |
| Clear | (ConfigurationSectionWithCollection から継承。) |
| Get | (ConfigurationSectionWithCollection から継承。) |
| GetAllowDefinition | (ConfigurationSection から継承。) |
| GetAllowLocation | (ConfigurationSection から継承。) |
| 削除 | (ConfigurationSectionWithCollection から継承。) |
| RevertToParent | (ConfigurationSection から継承。) |
| SetAllowDefinition | (ConfigurationSection から継承。) |
| SetAllowLocation | (ConfigurationSection から継承。) |
プロパティ
次の表は、CachingSection クラスによって公開されるプロパティの一覧です。
| 名前 | 説明 |
|---|---|
Enabled |
読み取り/書き込みの boolean 値。 出力キャッシュを有効にする場合は true。それ以外の場合は false。 出力キャッシュが無効になっている場合、応答出力キャッシュやカーネル キャッシュは行われません。 既定値は、true です。 |
EnableKernelCache |
読み取り/書き込みの boolean 値。 カーネル キャッシュが有効になっている場合は true。それ以外の場合は false。 既定値は、true です。 |
Location |
(ConfigurationSection から継承。)キー プロパティ。 |
MaxCacheSize |
出力キャッシュの最大サイズ (MB) を指定する読み取り/書き込みの uint32 値。 既定値は 0 です。 値 0 は、キャッシュ メモリ サイズが自動的に管理されることを意味します。 サイズ MaxValue は、キャッシュ サイズに制限がないことを意味します。 注: この設定は、ApplicationHost.config ファイルのレベルでのみ有効です。 このプロパティをこれより低いレベルで設定した場合、効果はありません。 |
MaxResponseSize |
出力キャッシュに格納できる応答の最大サイズ (バイト単位) を指定する読み取り/書き込みの uint32 値。 既定値は 262144 (256 KB) です。 値 0 は制限なしを意味します。 注: この設定は、ApplicationHost.config ファイルのレベルでのみ有効です。 このプロパティをこれより低いレベルで設定した場合、効果はありません。 |
Path |
(ConfigurationSection から継承。)キー プロパティ。 |
Profiles |
特定の要求の拡張子のキャッシュを構成する CachingProfileSettings 値。 |
SectionInformation |
(ConfigurationSection から継承。) |
サブクラス
このクラスにはサブクラスが含まれていません。
例
次の例では、Profiles 配列プロパティの CachingProfileSettings 値など、既定の Web サイトの CachingSection オブジェクトのプロパティを表示します。 Policy、KernelCachePolicy、および Location の各列挙型のテキストを表示する 2 つのヘルパー関数が用意されています。
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Get the CachingSection 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 other non-array CachingSection properties.
WScript.Echo "Enabled: " & oSection.Enabled
Wscript.Echo "EnableKernelCache: " & oSection.EnableKernelCache
Wscript.Echo "MaxCacheSize: " & oSection.MaxCacheSize
Wscript.Echo "MaxResponseSize: " & oSection.MaxResponseSize
Wscript.Echo
' Display the caching profiles from the Profiles property.
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 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
継承階層
ConfigurationSectionWithCollection
CachingSection
要件
| 型 | 説明 |
|---|---|
| クライアント | - 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 クラス
CachingProfileElement クラス
CachingProfileSettings クラス
ConfigurationSection クラス
ConfigurationSectionWithCollection クラス
HttpClientCache クラス