Compartilhar via

<Cache> ASP Cache

  • Artigo

Visão geral

O elemento <cache> do elemento <asp> especifica as seguintes configurações de cache do ASP (Active Server Pages) para o IIS (Serviços de Informações da Internet) 7, que podem controlar o comportamento de desempenho do ASP:

  • O atributo diskTemplateCacheDirectory contém o nome do diretório que o ASP usa para armazenar modelos ASP compilados no disco após o estouro do cache na memória. Se o diretório padrão for alterado, você precisará garantir que a identidade dos processos que executam o ASP tenha recebido direitos de controle total ao novo diretório.
  • O atributo enableTypelibCache especifica se as bibliotecas de tipos são armazenadas em cache no servidor.
  • O valor do atributo maxDiskTemplateCacheFiles especifica o número máximo de modelos ASP compilados que podem ser armazenados. (O diretório que armazena os modelos compilados é configurado pelo atributo diskTemplateCacheDirectory.)
  • O atributo scriptFileCacheSize especifica o número de arquivos de script pré-compilados a serem armazenados em cache. Se definido como 0, nenhum arquivo de script será armazenado em cache. Se definido como 4294967295, todos os arquivos de script solicitados serão armazenados em cache. Esse atributo é usado para ajustar o desempenho, dependendo da quantidade de memória disponível e da quantidade de tráfego de arquivo de script.
  • O atributo scriptEngineCacheMax especifica o número máximo de mecanismos de script que as páginas ASP manterão armazenados em cache na memória.

Compatibilidade

Versão Observações
IIS 10.0 O elemento <cache> não foi modificado no IIS 10.0.
IIS 8.5 O elemento <cache> não foi modificado no IIS 8.5.
IIS 8.0 O elemento <cache> não foi modificado no IIS 8.0.
IIS 7.5 O elemento <cache> não foi modificado no IIS 7.5.
IIS 7.0 O elemento <cache> do elemento <asp> foi introduzido no IIS 7.0.
IIS 6,0 O elemento <cache> substitui as seguintes propriedades de metabase dos IIS 6.0:
  • AspDiskTemplateCacheDirectory
  • AspEnableTypelibCache
  • AspMaxDiskTemplateCacheFiles
  • AspScriptEngineCacheMax
  • AspScriptFileCacheSize

Instalação

Para dar suporte e configurar aplicativos ASP em seu servidor Web, instale o módulo ASP. Execute as etapas a seguir para instalar o módulo ASP.

Windows Server 2012 R2 ou Windows Server 2012

  1. Na barra de tarefas, clique em Gerenciador do Servidor.
  2. No Gerenciador do Servidor, clique no menu Gerenciar e clique em Adicionar Funções e Recursos.
  3. No assistente Adicionar Funções e Recursos, clique em Avançar. Selecione o tipo de instalação e clique em Avançar. Selecione o servidor de destino e clique em Avançar.
  4. Na página Funções de Servidor, expanda Servidor Web (IIS), Servidor Web, Desenvolvimento do Aplicativo e selecionar ASP.
    Screenshot that shows A S P selected for Windows Server 2012.
  5. Se a caixa de diálogo Adicionar recursos exigidos pelo ASP? for exibida, clique em Adicionar recursos. (Esta página só será exibida se você ainda não tiver instalado o serviço de função Extensões ISAPI no seu servidor.)
  6. Na página Funções do Servidor, clique em Avançar.
  7. Na página Selecionar recursos, clique em Avançar.
  8. Na página Confirmar seleções de instalação, clique em Instalar.
  9. Na página Resultados , clique em Fechar.

Windows 8 ou Windows 8.1

  1. Na tela Iniciar, mova o ponteiro até o canto inferior esquerdo, clique com o botão direito do mouse no botão Iniciar e clique em Painel de Controle.

  2. Em Painel de Controle, clique em Programas e Recursos e clique em Ativar ou desativar recursos do Windows.

  3. Expanda Serviços de Informações da Internet, Serviços da World Wide Web, Recursos de Desenvolvimento de Aplicativos e selecione ASP.
    Screenshot that shows A S P selected for Windows 8.

    Observação

    A função Extensões ISAPI será selecionada se ainda não tiver sido instalada.

  4. Clique em OK.

  5. Clique em Fechar.

Windows Server 2008 R2 ou Windows Server 2008

  1. Na barra de tarefas, clique em Iniciar, vá para Ferramentas Administrativas e clique em Gerenciador do Servidor.
  2. No painel de hierarquia do Gerenciador do Servidor, expanda Funções e clique em Servidor Web (IIS).
  3. No painel Servidor Web (IIS), role até a seção Serviços de Função e clique em Adicionar Serviços de Função.
  4. Na página Selecionar Serviços de Função do Assistente para Adicionar Serviços de Função, selecione ASP.
    Screenshot that shows the Select Role Services page in the Add Role Services dialog box. A S P is selected under the Application Development node.
  5. Se a caixa de diálogo Adicionar serviços de função exigidos pelo ASP for exibida, clique em Adicionar Serviços de Função Necessários. (Esta página só será exibida se você ainda não tiver instalado o serviço de função Extensões ISAPI no seu servidor.)
    Screenshot that shows the Add Role Services message box.
  6. Na página Selecionar Serviços de Função, clique em Avançar.
  7. Na página Confirmar Seleções de Instalação, clique em Instalar.
  8. Na página Resultados , clique em Fechar.

Windows Vista ou Windows 7

  1. Na barra de tarefas, clique em Iniciar e, depois, em Painel de Controle.
  2. Em Painel de Controle, clique em Programas e Recursos e clique em Ativar ou desativar Recursos do Windows.
  3. Expanda Serviços de Informações da Internet, em seguida, World Wide Web Services e Recursos de Desenvolvimento de Aplicativos.
  4. Selecione ASP e clique em OK.
    Screenshot that shows A S P selected for Windows 7.

Instruções

Como definir as configurações do cache ASP para um servidor

  1. Abra o Gerenciador dos Serviços de Informações da Internet (IIS):

    • Caso você esteja usando o Windows Server 2012 ou o Windows Server 2012 R2:

      • Na barra de tarefas, clique em Gerenciador do Servidor, em Ferramentas e em Gerenciador dos Serviços de Informações da Internet (IIS).

    • Se você estiver usando o Windows 8 ou Windows 8.1:

      • Mantenha pressionada a tecla Windows, pressione a letra X e clique em Painel de Controle.
      • Clique em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).

    • Caso você esteja usando o Windows Server 2008 ou o Windows Server 2008 R2:

      • Na barra de tarefas, clique em Iniciar, vá para Ferramentas Administrativas e clique em Gerenciador dos Serviços de Informações da Internet (IIS).

    • Se você estiver usando o Windows Vista ou Windows 7:

      • Na barra de tarefas, clique em Iniciar e, depois, em Painel de Controle.
      • Clique duas vezes em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).

  2. No painel Conexões, realce o nome do servidor.

  3. No painel Página Inicial do servidor, clique duas vezes em ASP.
    Screenshot that shows the Server Home pane. A S P is selected.

  4. No painel ASP, expanda a seção propriedades de cache, defina as configurações desejadas e clique em Aplicar no painel Ações.
    Screenshot that shows the A S P pane. Caching Properties is selected and expanded.

Configuração

Atributos

Atributo Descrição
diskTemplateCacheDirectory Atributo de cadeia de caracteres opcional.

Especifica o nome do diretório no qual os repositórios ASP compilaram modelos ASP durante o estouro do cache na memória.

O valor padrão é %SystemDrive%\inetpub\temp\ASP Compiled Templates.
enableTypelibCache Atributo booliano opcional.

Especifica se as bibliotecas de tipos são armazenadas em cache.

O valor padrão é true.
maxDiskTemplateCacheFiles Atributo uint opcional.

Especifica o número máximo de modelos ASP compilados que podem ser armazenados. Esse valor é um inteiro entre 0 a 2147483647.

O valor padrão é 2000.
scriptEngineCacheMax Atributo uint opcional.

Especifica o número máximo de mecanismos de script que as páginas ASP manterão armazenadas em cache na memória. Esse valor é um inteiro entre 0 a 2147483647.

O valor padrão é 250.
scriptFileCacheSize Atributo uint opcional.

Especifica o número de arquivos de script pré-compilados para cache. Se definido como 0, nenhum arquivo de script será armazenado em cache. Se definido como 4294967295, todos os arquivos de script solicitados serão armazenados em cache. Esse atributo é usado para ajustar o desempenho, dependendo da quantidade de memória disponível e da quantidade de tráfego de arquivo de script.

O valor padrão é 500.

Elementos filho

Nenhum.

Exemplo de configuração

O exemplo de configuração a seguir define o diretório para o cache de modelo ASP, o número máximo de modelos ASP compilados que podem ser armazenados como 400, o número de arquivos de script pré-compilados para armazenar em cache como 1000 e o número máximo de mecanismos de script que as páginas ASP manterão armazenados em cache na memória para 500.

<configuration>
   <system.webServer>
      <asp>
         <cache maxDiskTemplateCacheFiles="4000"
            diskTemplateCacheDirectory="%SystemDrive%\inetpub\temp\ASP Compiled Templates"
            scriptFileCacheSize="1000"
            scriptEngineCacheMax="500"
         />
      </asp>
   </system.webServer>
</configuration>

Exemplo de código

Os códigos de exemplo a seguir definem o diretório para o cache de modelo ASP, o número máximo de modelos ASP compilados que podem ser armazenados como 400, o número de arquivos de script pré-compilados para armazenar em cache como 1000 e o número máximo de mecanismos de script que as páginas ASP manterão armazenados em cache na memória para 500.

AppCmd.exe

appcmd.exe set config -section:system.webServer/asp /cache.diskTemplateCacheDirectory:"%SystemDrive%\inetpub\temp\ASP Compiled Templates" /commit:apphost
appcmd.exe set config -section:system.webServer/asp /cache.maxDiskTemplateCacheFiles:"4000" /commit:apphost
appcmd.exe set config -section:system.webServer/asp /cache.scriptFileCacheSize:"1000" /commit:apphost
appcmd.exe set config -section:system.webServer/asp /cache.scriptEngineCacheMax:"500" /commit:apphost

Observação

Defina o parâmetro commit para apphost quando usar AppCmd.exe para definir essas configurações. Isso confirma as definições de configuração para a seção de local apropriado no arquivo ApplicationHost.config.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection aspSection = config.GetSection("system.webServer/asp");

         ConfigurationElement cacheElement = aspSection.GetChildElement("cache");
         cacheElement["diskTemplateCacheDirectory"] = @"%SystemDrive%\inetpub\temp\ASP Compiled Templates";
         cacheElement["maxDiskTemplateCacheFiles"] = 4000;
         cacheElement["scriptFileCacheSize"] = 1000;
         cacheElement["scriptEngineCacheMax"] = 500;

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim aspSection As ConfigurationSection = config.GetSection("system.webServer/asp")

      Dim cacheElement As ConfigurationElement = aspSection.GetChildElement("cache")
      cacheElement("diskTemplateCacheDirectory") = "%SystemDrive%\inetpub\temp\ASP Compiled Templates"
      cacheElement("maxDiskTemplateCacheFiles") = 4000
      cacheElement("scriptFileCacheSize") = 1000
      cacheElement("scriptEngineCacheMax") = 500

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST");

var cacheElement = aspSection.ChildElements.Item("cache");
cacheElement.Properties.Item("diskTemplateCacheDirectory").Value = "%SystemDrive%\\inetpub\\temp\\ASP Compiled Templates";
cacheElement.Properties.Item("maxDiskTemplateCacheFiles").Value = 4000;
cacheElement.Properties.Item("scriptFileCacheSize").Value = 1000;
cacheElement.Properties.Item("scriptEngineCacheMax").Value = 500;

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST")

Set cacheElement = aspSection.ChildElements.Item("cache")
cacheElement.Properties.Item("diskTemplateCacheDirectory").Value = "%SystemDrive%\inetpub\temp\ASP Compiled Templates"
cacheElement.Properties.Item("maxDiskTemplateCacheFiles").Value = 4000
cacheElement.Properties.Item("scriptFileCacheSize").Value = 1000
cacheElement.Properties.Item("scriptEngineCacheMax").Value = 500

adminManager.CommitChanges()