Partilhar via


Ferramenta de inscrição do navegador do ASP.NET (Aspnet_regbrowsers.exe)

A ferramenta de inscrição do ASP.NET no navegador analisa e compila todas as definições de navegador de todo o sistema em um assembly e instala o assembly para o cache de assembly global. A ferramenta utiliza os arquivos de definição de navegador (.BROWSER arquivos) do .NET estrutura navegadores subdiretório. A ferramenta pode ser encontrada no %SystemRoot%\Microsoft.NET\estrutura\ versão \ diretório.

No ASP.NET versão 1.1, a computador. arquivo de configuração continha uma seção chamada <browserCaps>. Esta seção contém uma série de entradas XML que definidas as configurações para vários navegadores com base em uma expressão regular. Para o ASP.NET versão 2.0, um novo arquivo .BROWSER define os parâmetros de um navegador específico usando entradas XML. Adicione informações em um novo navegador adicionando um novo arquivo .BROWSER a pasta localizada em %SystemRoot%\Microsoft.NET\estrutura\ versão \CONFIG\Browsers em seu sistema.

Porque um aplicativo não está lendo um arquivo .config toda vez que ele requer informações sobre o navegador, você pode criar um novo arquivo .BROWSER e executar Aspnet_regbrowsers.exe para adicionar as alterações necessárias para o assembly. Isso permite que o servidor acesso as novas informações do navegador imediatamente para que você não tenha desligado a nenhum dos seus aplicativos para pegar as informações. Um aplicativo pode acessar recursos do navegador através de Browser propriedade do corrente HttpRequest.

Sintaxe

aspnet_regbrowsers.exe <options>

Opções

Opção

Descrição

-?

Exibe o texto Aspnet_regbbrowsers.exe ajuda na janela Comando.

-i

Cria o assembly dos recursos do navegador em tempo de execução e o instala na cache de assembly global.

-u

Desinstala o assembly dos recursos do navegador em tempo de execução do cache global de assemblies.

Comentários

Arquivos de definição de navegador podem ser todo o sistema ou aplicativos específicos e cada tipo é armazenado em um local diferente. Navegador de todo o sistema definição arquivos é armazenados no %SystemRoot%\Microsoft.NET\estrutura\ versão \CONFIG\Browsers diretório. Este diretório contém arquivos de definição de navegador predefinido que acompanha a versão correspondente do .NET estrutura e quaisquer arquivos de definição de navegador adicionais lá copiados de atualizações de software ou serviço packs. Não altere os arquivos de definição de navegador predefinido vêm com o ASP.NET, porque os serviço packs pode atualização esses arquivos e substituir as alterações.

Arquivos de definição de navegador específico do aplicativo podem ser colocados no diretório de App_Browsers do aplicativo. Nos dois locais, arquivos de definição de navegador devem ter uma extensão de nome de arquivo .BROWSER. Usar a ferramenta de inscrição do ASP.NET no navegador não tem efeito em arquivos com definições de navegadores específicos de aplicativo armazenados no diretório de App_Browsers do aplicativo.

Quando os arquivos de definição de navegador no nível do sistema forem modificados, eles não causam automaticamente uma atualização de recursos do navegador para todos os aplicativos. Você deve executar a ferramenta de inscrição do ASP.NET no navegador para atualizar o assembly dos recursos do navegador.

ObservaçãoObservação:

A ferramenta de inscrição do navegador ASP.NET compila definições de navegador no diretório de navegadores da versão do .NET estrutura que corresponde à versão da ferramenta. Cada versão do .NET estrutura tem sua própria cópia da ferramenta.

A ferramenta de inscrição do navegador ASP.NET analisa e compila todas as definições de navegador de todo o sistema em um assembly e instala o conjunto no cache de assembly global. Se houver erros nas definições de navegador de todo o sistema, a ferramenta relata os erros. O assembly dos recursos do navegador é usado por todos os aplicativos da Web no sistema. Observe que também programaticamente pode recompilar os arquivos de definição de navegador de todo o sistema usando o BrowserCapabilitiesCodeGenerator classe.

Comportamento

Quando é executado a ferramenta de inscrição do ASP.NET no navegador, é criado um novo assembly e o efeito em todos sistema autônomo aplicativos da Web é o mesmo sistema autônomo se o computador. arquivo de configuração foi alterado: Todos os aplicativos da Web são reciclados e Serviços de Informações da Internet da Microsoft (IIS) é reiniciado. A ferramenta também gera um arquivo de token privado aleatório e cria um arquivo de chave para assinar o conjunto para que o assembly pode ser instalado no cache de assembly global. O arquivo de chave é removido quando a ferramenta for concluída, deixando somente a chave pública.

Em tempo de execução, informações do arquivo de definição do navegador são mescladas em uma coleção de navegadores conhecidos em um objeto BrowserCapabilitiesFactory. Quando uma solicitação é feita, ASP.NET identifica o navegador solicitante, o cabeçalho de solicitação e compila um HttpBrowserCapabilities objeto que corresponde ao tipo de navegador solicitado.

ObservaçãoObservação:

Usando o <browserCaps> elemento no arquivo Web.config para definir navegadores é preterido no .NET estrutura versão 2.0, mas ainda é suportado. Os dados desse elemento serão mesclados com as informações de arquivos de definição de navegador.

Por outro lado, os arquivos de definições de navegador no nível do aplicativo são automaticamente analisados e compilados por demanda quando o aplicativo é iniciado. Se as alterações são feitas o diretório do aplicativo navegadores, o aplicativo automaticamente é recompilado. A ferramenta de inscrição do ASP.NET no navegador não tem efeito sobre arquivos de informações do navegador de nível de aplicativo.

Exemplos

Para analisar e compilar todas as definições de navegador de todo o sistema em um assembly e instalar o assembly para o cache de assemblies global, executar Aspnet_regbrowsers.exe. O comando a seguir cria e instala o assembly:

C:\WINDOWS\Microsoft.NET\Framework\<versionNumber>\aspnet_regsql.exe -i

Você também pode usar a ferramenta para remover o conjunto de definição de navegador do cache de assembly global. O comando a seguir remove o conjunto de definições de navegador do cache de assemblies global:

aspnet_regsql.exe -u

Para obter ajuda sobre como usar a ferramenta de inscrição do ASP.NET no navegador, use o seguinte comando:

aspnet_regsql.exe -?

Consulte também

Tarefas

Como: Detectar tipos de navegador em páginas da Web do ASP.NET

Conceitos

Controles de Servidor Web do ASP.NET e Recursos do Navegador

Protegendo arquivos de definição do navegador

Referência

BrowserCapabilitiesFactory

Browser

HttpCapabilitiesBase

Navegador Definition Arquivo Esquema (navegadores elemento)