Compartir a través de


Herramienta Registro de explorador ASP.NET (Aspnet_regbrowsers.exe)

Actualización: noviembre 2007

La herramienta Registro de explorador ASP.NET analiza y compila todas las definiciones de explorador del sistema en un ensamblado e instala el ensamblado en la caché de ensamblados global. La herramienta utiliza los archivos de definición de explorador (archivos .BROWSER) del subdirectorio de exploradores de .NET Framework. La herramienta está ubicada en el directorio %SystemRoot%\Microsoft.NET\Framework\versión\.

En ASP.NET 1.1, el archivo Machine.config incluía una sección denominada <browserCaps>. Esta sección contenía una serie de entradas XML que definían la configuración de varios exploradores basándose en una expresión regular. En ASP.NET 2.0, un nuevo archivo .BROWSER define los parámetros de un explorador determinado utilizando entradas XML. Para agregar información en un explorador nuevo se agrega un nuevo archivo .BROWSER a la carpeta ubicada en el directorio %RaízSistema%\Microsoft.NET\Framework\versión\CONFIG\Browser del sistema.

Dado que una aplicación no lee un archivo .config cada vez que requiere información del explorador, se puede crear un nuevo archivo .BROWSER y ejecutar Aspnet_regbrowsers.exe para agregar los cambios necesarios al ensamblado. De este modo, el servidor puede obtener acceso inmediato a la nueva información de explorador, por lo que no es necesario cerrar ninguna aplicación para obtener la información. Una aplicación puede obtener acceso a las funciones del explorador a través de la propiedad Browser de la actual HttpRequest.

Sintaxis

aspnet_regbrowsers.exe <options>

Opciones

Opción

Descripción

-?

Muestra el texto de la Ayuda de Aspnet_regbbrowsers.exe en la ventana de comandos.

-i

Crea el ensamblado de funciones de explorador en tiempo de ejecución y lo instala en la caché de ensamblados global.

-u

Desinstala el ensamblado de funciones de explorador en tiempo de ejecución de la caché de ensamblados global.

Comentarios

Los archivos de definición de explorador pueden ser para todo el sistema o pueden ser específicos de la aplicación; cada tipo se almacena en una ubicación diferente. Los archivos de definición de explorador del sistema se encuentran almacenados en el directorio %RaízSistema%\Microsoft.NET\Framework\versión\CONFIG\Browsers. Este directorio contiene los archivos de definición de explorador predefinidos que están incluidos en la versión correspondiente de .NET Framework y los archivos de definición de explorador adicionales copiados en dicha ubicación procedentes de actualizaciones de software o Service Pack. No cambie los archivos de definición de explorador predefinidos que vienen con ASP.NET porque los Service Pack podrían actualizar esos archivos y sobrescribir los cambios.

Los archivos de definición de explorador específicos de la aplicación pueden almacenarse en el directorio App_Browsers de la aplicación. En ambas ubicaciones, los archivos de definición de explorador deben tener la extensión de nombre de archivo .BROWSER. El uso de la herramienta Registro de explorador ASP.NET no tiene ningún efecto en los archivos de definición de explorador específicos de la aplicación que están almacenados en el directorio App_Browsers de una aplicación.

Cuando se modifican los archivos de definición de explorador para todo el sistema, no se actualizan automáticamente las funciones del explorador para todas las aplicaciones. Es preciso ejecutar la herramienta Registro de explorador ASP.NET para actualizar el ensamblado de funciones de explorador.

Nota

La herramienta Registro de explorador ASP.NET compila las definiciones de explorador en el directorio de exploradores de la versión de .NET Framework correspondiente a la versión de la herramienta. Cada versión de .NET Framework tiene su propia copia de la herramienta.

La herramienta Registro de explorador ASP.NET analiza y compila todas las definiciones de explorador del sistema en un ensamblado e instala el ensamblado en la caché de ensamblados global. Si hay errores en las definiciones de explorador del sistema, la herramienta crea un informe de esos errores. Todas las aplicaciones Web del sistema utilizan el ensamblado de funciones de explorador. Observe que también se puede volver a compilar mediante programación los archivos de definición de explorador del sistema utilizando la clase BrowserCapabilitiesCodeGenerator.

Comportamiento

Cuando se ejecuta la herramienta Registro de explorador ASP.NET, se crea un nuevo ensamblado y el efecto en todas las aplicaciones Web es el mismo que si se cambiara el archivo Machine.config. Todas las aplicaciones Web que se están ejecutando se reciclan e Internet Information Services (IIS) se reinicia. La herramienta también genera un archivo de símbolos (token) privados y aleatorios, además de crear un archivo de clave para firmar el ensamblado de modo que éste pueda instalarse en la caché de ensamblados global. El archivo de clave se quita cuando finaliza la herramienta, dejando sólo la clave pública.

En tiempo de ejecución, la información del archivo de definición de explorador se combina en una colección de exploradores conocidos en un objeto BrowserCapabilitiesFactory. Cuando se realiza una solicitud, ASP.NET identifica el explorador solicitante mediante el encabezado de la solicitud y compila un objeto HttpBrowserCapabilities que corresponde al tipo del explorador solicitante.

Nota

En .NET Framework 2.0, ya no se utiliza el elemento <browserCaps> en el archivo Web.config para definir los exploradores, pero aún se admite su uso. Los datos de este elemento se combinan con la información de los archivos de definición del explorador.

Por contraste, los archivos de definición de explorador específicos de la aplicación se analizan y se compilan automáticamente a petición cuando se inicia la aplicación. Si se realiza algún cambio en el directorio de exploradores de la aplicación, la aplicación vuelve a compilarse automáticamente. La herramienta Registro de explorador ASP.NET no tiene ningún efecto en los archivos de información del explorador específicos de la aplicación.

Ejemplos

Para analizar y compilar todos las definiciones de explorador del sistema en un ensamblado e instalar el ensamblado en la caché de ensamblados global, ejecute Aspnet_regbrowsers.exe. El siguiente comando crea e instala el ensamblado:

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

Asimismo, se puede utilizar la herramienta para quitar el ensamblado de definiciones de explorador de la caché de ensamblados global. El siguiente comando quita el ensamblado de definiciones de explorador de la caché de ensamblados global:

aspnet_regsql.exe -u

Para obtener ayuda sobre cómo utilizar la herramienta Registro de explorador ASP.NET, utilice el comando siguiente:

aspnet_regsql.exe -?

Vea también

Tareas

Cómo: Detectar tipos de explorador en páginas Web ASP.NET

Conceptos

Controles de servidor Web ASP.NET y funciones del explorador

Proteger archivos de definición de explorador

Referencia

BrowserCapabilitiesFactory

Browser

HttpCapabilitiesBase

Esquema de archivos de definición de explorador (Elemento browsers)