Herramienta Registro de explorador ASP.NET (Aspnet_regbrowsers.exe)
La herramienta Registro de explorador ASP.NET (Asnet_regbrowsers.exe) analiza y compila todas las definiciones de explorador del sistema en un ensamblado, que instala en la memoria caché global de ensamblados. La herramienta utiliza los archivos de definición de explorador (archivos .BROWSER) del subdirectorio de exploradores de .NET Framework.
Nota
Para obtener información sobre cómo encontrar la versión correcta de Asnet_regbrowsers.exe, vea Encontrar la versión correcta de Aspnet_regbrowsers.exe más adelante en este mismo tema.
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é global de ensamblados. |
-u |
Desinstala el ensamblado de funciones de explorador en tiempo de ejecución de la caché global de ensamblados. |
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 de todo el sistema se almacenan en la siguiente ruta de acceso:
%RaízSistema%\Microsoft.NET\Framework\versión\CONFIG\Browsers
Este directorio contiene los archivos de definición de explorador predefinidos que se incluyen con 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. Puede agregar nuevos archivos de explorador para las definiciones de explorador que desea que estén disponibles de forma global en las aplicaciones web. Sin embargo, no debe cambiar 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. 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 Browsers, situado bajo %RaízSistema%, que se corresponde con el directorio Framework, situado bajo %WinDir%, desde el que ejecuta la herramienta.La versión de la herramienta que se proporciona con .NET Framework 2.0 actualiza el ensamblado de definición de explorador de los sitios web que tienen como destino .NET Framework 2.0, .NET Framework 3.0 o .NET Framework 3.5. La versión que se proporciona con .NET Framework 4 actualiza el ensamblado de definición de explorador de los sitios web que tienen como destino .NET Framework 4.
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é global de ensamblados. 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é global de ensamblados. 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 de definición de explorador se combina en una colección de exploradores conocidos de 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
.NET Framework 1.1 almacena las definiciones de explorador en el elemento browserCaps del archivo Web.config.En esta sección ya no se usa la versión 2.0 de .NET Framework, pero todavía se admite.Los datos de este elemento se combinan con la información de los archivos de definición del explorador.
Los archivos de definición de explorador se analizan y compilan junto con los demás archivos de origen de la aplicación. En un proyecto de sitio web, la compilación se lleva a cabo a petición, cuando se inicia la aplicación. La aplicación se recompila después automáticamente cuando se realiza algún cambio en el directorio Browsers. 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 todas las definiciones de explorador del sistema en un ensamblado e instalar el ensamblado en la memoria caché global de ensamblados, ejecute el comando siguiente:
aspnet_ regbrowsers.exe -i
Asimismo, se puede utilizar la herramienta para quitar el ensamblado de definiciones de explorador de la caché global de ensamblados. El siguiente comando quita el ensamblado de definiciones de explorador de la caché global de ensamblados:
aspnet_ regbrowsers.exe -u
Para obtener ayuda sobre cómo utilizar la herramienta Registro de explorador ASP.NET, utilice el comando siguiente:
aspnet_ regbrowsers.exe -?
Encontrar la versión correcta de Aspnet_regbrowsers.exe
Aspnet_regbrowsers.exe se instala en el directorio de Microsoft .NET Framework. Si en el equipo se ejecutan varias versiones de .NET Framework en paralelo, es posible que haya varias versiones de la herramienta instaladas. En la tabla siguiente se muestran las ubicaciones en las que se instala la herramienta en las diferentes versiones de .NET Framework.
Versión de .NET Framework |
Ubicación del archivo Aspnet_regbrowsers.exe |
|---|---|
.NET Framework versión 2.0, versión 3.0 y versión 3.5 (sistemas de 32 bits) |
%windir%\Microsoft.NET\Framework\v2.0.50727 |
.NET Framework versión 2.0, versión 3.0 y versión 3.5 (sistemas de 64 bits) |
%windir%\Microsoft.NET\Framework64\v2.0.50727 |
.NET Framework versión 4 (sistemas de 32 bits) |
%windir%\Microsoft.NET\Framework\v4.0.30319 |
.NET Framework versión 4 (sistemas de 64 bits) |
%windir%\Microsoft.NET\Framework64\v4.0.30319 |
Vea también
Tareas
Cómo: Detectar tipos y capacidades de explorador en páginas web ASP.NET
Referencia
Esquema de archivos de definición de explorador (Elemento browsers)
Conceptos
Controles de servidor web ASP.NET y funciones del explorador