Classe CachingSection

Artigo
03/25/2024

Configura o cache de saída e do kernel.

Sintaxe

class CachingSection : ConfigurationSectionWithCollection

Métodos

A tabela a seguir lista os métodos expostos pela classe CachingSection.

Nome	Descrição
Add	(Herdado de ConfigurationSectionWithCollection.)
Limpar	(Herdado de `ConfigurationSectionWithCollection`.)
Get	(Herdado de `ConfigurationSectionWithCollection`.)
GetAllowDefinition	(Herdado de ConfigurationSection.)
GetAllowLocation	(Herdado de `ConfigurationSection`.)
Remover	(Herdado de `ConfigurationSectionWithCollection`.)
RevertToParent	(Herdado de `ConfigurationSection`.)
SetAllowDefinition	(Herdado de `ConfigurationSection`.)
SetAllowLocation	(Herdado de `ConfigurationSection`.)

Propriedades

A tabela a seguir lista as propriedades expostas pela classe CachingSection.

Nome	Descrição
`Enabled`	Um valor `boolean` de leitura/gravação. `true` se o cache de saída estiver habilitado; caso contrário, `false`. Se o cache de saída estiver desabilitado, nenhum cache de saída de resposta ou cache de kernel ocorrerá. O padrão é `true`.
`EnableKernelCache`	Um valor `boolean` de leitura/gravação. `true` se o cache de kernel estiver habilitado; caso contrário, `false`. O padrão é `true`.
`Location`	(Herdado de `ConfigurationSection`.) Uma propriedade chave.
`MaxCacheSize`	Um valor `uint32` de leitura/gravação que especifica o tamanho máximo, em megabytes, do cache de saída. O padrão é 0. Um valor 0 significa que o tamanho da memória cache é gerenciado automaticamente. Um tamanho de `MaxValue` significa que não há limite no tamanho do cache. Observação: essa configuração é efetiva somente no nível do arquivo ApplicationHost.config. Se você definir essa propriedade em um nível inferior, ela não terá efeito.
`MaxResponseSize`	Um valor `uint32` de leitura/gravação que especifica o tamanho máximo, em bytes, de uma resposta que pode ser armazenada no cache de saída. O padrão é 262144 (256KB). Uma configuração de 0 significa que não há limite. Observação: essa configuração é efetiva somente no nível do arquivo ApplicationHost.config. Se você definir essa propriedade em um nível inferior, ela não terá efeito.
`Path`	(Herdado de `ConfigurationSection`.) Uma propriedade chave.
`Profiles`	Um valor CachingProfileSettings que configura o cache para extensões de solicitação específicas.
`SectionInformation`	(Herdado de `ConfigurationSection`.)

Subclasses

Essa classe não contém subclasses.

Exemplo

O exemplo a seguir exibe propriedades no objeto CachingSection do site padrão, incluindo os valores CachingProfileSettings na propriedade de matriz Profiles. Duas funções auxiliares são fornecidas para exibir texto para as enumerações Policy, KernelCachePolicy e Location.

' 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

Hierarquia de herança

ConfigurationSection

ConfigurationSectionWithCollection

CachingSection

Requisitos

Tipo	Descrição
Cliente	– IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10
Servidor	– IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016
Product	– IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Arquivo MOF	WebAdministration.mof

Confira também

Classe AspCache
Classe CachingProfileElement
Classe CachingProfileSettings
Classe ConfigurationSection
Classe ConfigurationSectionWithCollection
Classe HttpClientCache

Compartilhar via