Classe CachingProfileElement

Configura o cache de uma determinada extensão de solicitação.

Sintaxe

class CachingProfileElement : CollectionElement  

Métodos

Essa classe não contém métodos.

Propriedades

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

Nome	Descrição
Duration	Um valor datetime de leitura/gravação que especifica a duração de permanência de uma resposta no cache. O padrão é 30 segundos. O intervalo de tempo válido é de 0 a 365 dias.
Extension	Um valor string de leitura/gravação exclusivo necessário que especifica a extensão de uma solicitação que usará o perfil de cache. A extensão deve estar no formato "EXT" ou "*", em que EXT é a extensão. A propriedade de chave. Observação: não são permitidas entradas de extensão sobrepostas. Cada solicitação é mapeada para exatamente um objeto CachingProfileElement. Se existir uma entrada com um "*", outros perfis de cache com extensões mais específicas substituirão o perfil com o asterisco. A ordenação de entradas de perfil não é importante.
KernelCachePolicy	Um valor sint32 de leitura/gravação que configura a política de cache do kernel. Os valores possíveis estão listados posteriormente na seção Comentários.
Location	Um valor sint32 de leitura/gravação que especifica possíveis locais para o cache de saída. Os valores possíveis estão listados posteriormente na seção Comentários.
Policy	Um valor sint32 de leitura/gravação que configura a política de cache de saída. Os valores possíveis estão listados posteriormente na seção Comentários.
VaryByHeaders	Um valor string de leitura/gravação que contém uma lista delimitada por vírgulas de nomes de cabeçalho que serão usados pelo servidor para variar as respostas armazenadas em cache para a URL.
VaryByQueryString	Um valor string de leitura/gravação que contém uma lista delimitada por vírgulas de nomes de parâmetros de cadeia de caracteres de consulta que serão usados pelo servidor para variar as respostas armazenadas em cache para a URL.

Subclasses

Essa classe não contém subclasses.

Comentários

Essa classe corresponde ao elemento <profiles> a seção <system.webServer/caching> no arquivo ApplicationHost.config. As instâncias desta classe estão contidas na propriedade matriz Profiles da classe CachingProfileSettings.

A tabela a seguir lista os possíveis valores da propriedade KernelCachePolicy. O padrão é 0 (DontCache).

Valor	Palavra-chave	Descrição
0	DontCache	A resposta não será armazenada em cache no kernel. No entanto, o cache de saída ainda pode ocorrer. Observação: esta configuração substitui quaisquer configurações conflitantes na propriedade Location.
1	CacheUntilChange	A resposta é armazenada no cache HTTP.SYS até que a entrada seja invalidada ou até que expire após o período de inatividade especificado pela propriedade Duration.
2	CacheForTimePeriod	A resposta é armazenada em cache pelo período de tempo especificado pela propriedade Duration, mesmo se a entrada for invalidada nesse ínterim.
3	DisableCache	O cache está desabilitado e nenhum armazenamento em cache ocorrerá.

A tabela a seguir lista os possíveis valores da propriedade Location. O padrão é 3 (Server).

Valor	Palavra-chave	Descrição
0	Any	A resposta pode ser armazenada em cache no cliente, servidor Web ou servidor proxy.
1	Client	A resposta é armazenada em cache somente no cliente.
2	Downstream	A resposta é armazenada em cache nos servidores proxy e no cliente, mas não no servidor Web.
3	Server	A resposta é armazenada em cache somente no servidor Web.
4	None	A resposta não é armazenada em cache em nenhum lugar.
5	ServerAndClient	A resposta é armazenada em cache no servidor Web e no cliente, mas não em servidores proxy. Observação: você pode usar essa configuração para evitar o compartilhamento de conteúdo entre vários usuários em caches de proxy quando o servidor tiver comportamento variável para conteúdo privado.

A tabela a seguir lista os possíveis valores da propriedade Policy. O padrão é 0 (DontCache).

Valor	Palavra-chave	Descrição
0	DontCache	A resposta não será colocada no cache de saída. No entanto, o cache do kernel ainda pode ocorrer.
1	CacheUntilChange	A resposta é armazenada em cache até que a entrada seja invalidada ou até que expire após o período de inatividade especificado pela propriedade Duration.
2	CacheForTimePeriod	A resposta é armazenada em cache pelo período de tempo especificado pela propriedade Duration, mesmo se a entrada for invalidada nesse ínterim.
3	DisableCache	O cache está desabilitado e nenhum armazenamento em cache ocorrerá.

Exemplo

O exemplo a seguir exibe todos os objetos CachingProfileElement para o site padrão.

' 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

Hierarquia de herança

CollectionElement

CachingProfileElement

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 CachingProfileSettings
Classe CachingSection
Classe CollectionElement
Classe HttpClientCache