Como: Configurar uma extensão de manipulador HTTP no IIS

  • Artigo

Por padrão, Serviços de Informações da Internet (IIS) passa as solicitações para somente determinados tipos de arquivo para o ASP.NET ao serviço.Arquivos com extensões de nome de arquivo como .aspx, .ascx, .asmx, e.ashx, já são mapeados para a extensão ISAPI do ASP.NET (Aspnet_isapi.dll).Isso se aplica ao IIS 6.0, a IIS 7.0 sendo executado no modo clássico e para manipuladores gerenciados no IIS 7.0 que estão executando no modo integrado.

Entretanto, para que o IIS passe extensões de nome de arquivo personalizadas para o ASP.NET, você deve registrar as extensões no IIS.Para obter mais informações sobre como manipuladores participam do ciclo de vida do aplicativo, consulte Ciclo de Vida do Aplicativo ASP.NET uma visão geral para o IIS 5.0 e 6.0 ou Uma visão geral do Ciclo de Vida do Aplicativo ASP.NET para o IIS 7.0.

Para mapear uma extensão de nome de arquivo no IIS

  1. Abra Gerenciador do IIS.

  2. Expanda o nó para o computador do servidor web, expanda Sites da Web e em seguida, expanda Site da Web Padrão.

  3. Clique com o botão direito do mouse no nome do seu aplicativo, e clique em Properties.

    Observação:

    Para obter informações adicionais sobre como criar um aplicativo ASP.NET, consulte Como: Criar e configurar local Web sites do ASP.NET no IIS 6.0.

  4. Clique na guia Diretório virtuale em seguida, clique em Configuração.

  5. Na guia Mapeamentos, clique em Adicionar.

    A caixa de diálogo Adicionar/Editar Mapeamento de Extensões do Aplicativo é exibida.

  6. No Executável caixa, digite ou procure o arquivo aspnet_isapi.dll.Por padrão, o arquivo é no seguinte local:

    %windows%\Microsoft.NET\Framework\version\
    Observação:

    Você pode obter o caminho completo e nome de arquivo de outros mapeamentos, como o mapeamento para arquivos .aspx.

  7. No Extensão caixa, digite o nome do arquivo de extensão, tais sistema autônomo .sample.

    Observação:

    Certifique-se que você incluiu o ponto (.) como parte da extensão do nome de arquivo.

  8. Selecione a caixa de seleção Verificar se o Arquivo Existe de acordo com o que representa a extensão do nome do arquivo no seu aplicativo.Escolha essas opções:

    • True.A extensão de nome de arquivo representa um arquivo físico no aplicativo.Nesse caso, se o arquivo solicitado não existir no disco, o IIS exibe um erro.

    • False.A extensão de nome de arquivo não representa um arquivo físico.Em vez disso, a extensão é tratada dinamicamente por uma classe que está mapeada para a extensão no ASP.NET.

  9. Clique em Ok, e então feche Gerenciador do IIS.

Para mapear uma extensão de nome de arquivo no IIS 7.0 executando no modo clássico

  1. Abra Gerenciador do IIS.

    Observação:

    No e Windows Server 2008, se o recurso de Controle de Conta de Usuário (UAC) está ativado, ele solicitará que você continue acesso ao gerenciador.Para obter mais informações, consulte Visão geral sobre o controle de conta de usuário.

  2. Expanda o nó para o computador do servidor web, expanda Sites da Web e em seguida, expanda Site da Web Padrão.

  3. Selecione o nó para o seu aplicativo.

    OO painel Exibição de Recursos é exibido.

  4. Em Exibição de Recursosr, clique duas vezes em Mapeamentos do Manipulador.

  5. No painel Ações,clique em Adicionar Mapeamento de Script.

    A caixa de diálogo Adicionar Mapeamento de Script é exibida.

  6. Na caixa de diálogo Adicionar Mapeamento de Script, especifique o seguinte:

    • Solicite caminho.O nome ou extensão de nome de arquivo para mapear.

    • Executável.O caminho do arquivo .exe ou .dll que irá lidar com a solicitação.Para modo clássico, especifique a extensão ISAPI do ASP.NET (aspnet_isapi.dll).

    • NomeUm nome descritivo.

  7. Clique em OK para fechar a caixa de diálogo Adicionar Regra de Estilo.

    Observação:

    Usando Gerenciador do IIS em IIS 7.0 para adicionar um manipulador personalizado de extensão é equivalente à registrar a extensão do manipulador no arquivo web.config de um aplicativo ASP.NET.O registro adiciona um elemento handler na seção handlers do grupo system.webServer.

  8. Abra o arquivo Web.config em seu aplicativo.

  9. Localize o elemento httpHandlers da seção system.web e adicione uma entrada para a extensão de nome de arquivo.

    Observação:

    A extensão de nome de arquivo deve ser registrada no elemento httpHandlers e no elemento handlers.

Para mapear uma extensão de nome de arquivo no IIS 7.0 sendo executado em modo Integrado.

  1. Siga as etapas de 1 a 3 do procedimento anterior.

  2. No painel Ações,clique em Adicionar Manipulador Gerenciado.

    A caixa de diálogo Adicionar Manipulador Gerenciado é exibida.

  3. Na caixa de diálogo Adicionar Manipulador Gerenciado, especifique o seguinte:

    • Solicite caminho.O nome ou extensão de nome de arquivo para mapear.

    • TipoO nome de tipo (classe) do manipulador gerenciado.Se o manipulador é definido na pasta App_Code do aplicativo ASP.NET, seu nome de tipo aparecerá na lista suspensa.

    • NomeUm nome descritivo.

  4. Clique em OK para fechar a caixa de diálogo Adicionar Manipulador Gerenciado.

    Observação:

    Usando Gerenciador do IIS em IIS 7.0 para adicionar um manipulador personalizado de extensão é equivalente à registrar a extensão do manipulador no arquivo web.config.
    Observação:

    Para um manipulador que serve uma extensão personalizada no IIS 7.0 executando no modo integrado, é necessário apenas um registro no elemento handlers.Se você quiser manter o registro no elemento httpHandlers também, crie um elemento validation na seção system.webServer (se ele não existir) e defina o atributo validateIntegratedModeConfiguration como false.Para mais informações, consulte Como: IIS 7.0 suprimir avisos de inscrição.

Consulte também

Tarefas

Como: Registrar manipuladores HTTP