Controles de servidor web ASP.NET y funciones del explorador

De manera predeterminada, ASP.NET determina las capacidades del explorador leyendo la información del agente de usuario que se pasa desde el explorador al servidor durante una solicitud. Compara la cadena del agente de usuario que se recibe del explorador con las cadenas del agente de usuario almacenadas en los archivos de definición del explorador. Estos archivos de definición del explorador contienen información sobre las capacidades de varios agentes de usuario. Cuando ASP.NET encuentra una coincidencia entre la cadena del agente de usuario actual y una cadena de agente de usuario en un archivo de definición del explorador, este carga las capacidades del explorador correspondientes en el objeto HttpBrowserCapabilities. A continuación, las propiedades del objeto HttpBrowserCapabilities se pueden usar para determinar si el tipo de explorador que representa el agente de usuario admite scripting, estilos, marcos, etc. En función de estas capacidades, los controles de la página presentan los controles web con el marcado correspondiente.

Nota
Las capacidades del explorador indican si el tipo de explorador en general admite características como JavaScript, no si una instancia individual del explorador tiene habilitadas o deshabilitadas estas características.

El objeto HttpBrowserCapabilities está disponible en la propiedad Browser del objeto HttpRequest. Puede tener acceso a información sobre algunas de las capacidades del explorador en las propiedades fuertemente tipadas del objeto HttpBrowserCapabilities. Otras capacidades se definen solamente en los archivos de definición del explorador y solo están disponibles como entradas en una colección de diccionarios.

Por ejemplo, para determinar si el tipo y la versión del explorador actual admiten una versión determinada de JavaScript, puede usar una propiedad que solo se defina en los archivos de definición del explorador (no en HttpBrowserCapabilitiesBase), como se muestra en el ejemplo siguiente:

string jsVersion = Request.Browser["JavaScriptVersion"];

Si el explorador que realiza la solicitud es Internet Explorer 8, la cadena jsVersion contendrá el valor "1.5".

Para determinar si la solicitud se originó desde un dispositivo móvil, puede usar la propiedad IsMobileDevice, como se muestra en el ejemplo siguiente:

bool isMobile = Request.Browser.IsMobileDevice;

ASP.NET almacena los archivos de definición del explorador predeterminados en la siguiente carpeta:

%SystemRoot%\Microsoft.NET\Framework\versionNumber\Config\Browsers

Nota
Los archivos de definición del explorador se actualizaron para ASP.NET 4 y las nuevas versiones no son compatibles con los archivos de este tipo proporcionados en las versiones anteriores de ASP.NET. Para obtener más información, vea Cómo: Actualizar una aplicación web de ASP.NET a ASP.NET 4.

Para definir tipos de explorador personalizados, cree nuevos archivos de definición del explorador y agréguelos a las carpetas ASP.NET Browsers o App_Browsers de un sitio web. Si actualiza o agrega archivos de definición del explorador a la carpeta ASP.NET Browsers, debe ejecutar la herramienta aspnet_regbrowsers.exe.

Nota

La sección browserCaps de los archivos de configuración (.config) está desusada. A efectos de compatibilidad con la versión anterior ASP.NET 1.1, la configuración incluida en la sección browserCaps sigue siendo efectiva si se establece en el nivel de la aplicación. Sin embargo, la configuración se combina con la información de los archivos de definición del explorador del nivel del equipo y cualquier carpeta App_Browser del nivel de la aplicación. Para obtener más información, vea Esquema de archivos de definición de explorador (Elemento browsers).

Si desea controlar de forma explícita la representación de la página en lugar de basarse en la detección automática del explorador, puede establecer la propiedad ClientTarget de la página. Dicha propiedad puede establecerse mediante declaración como atributo de la directiva @ Page para la página o puede establecerse mediante programación.

El valor de la propiedad ClientTarget es un alias del tipo de explorador en el que desea representar la página. Por ejemplo, si desea ver cómo se presentaría una página en Apple iPhone sin usar un emulador, puede crear un alias para el iPhone y establecer la propiedad ClientTarget en dicho alias. El alias que se especifica debe definirse en la sección clientTarget del archivo de configuración. Los valores predefinidos son uplevel y downlevel.

Puede crear alias adicionales si los define en el archivo Web.config raíz o en el archivo de aplicación Web.config. Para obtener más información, vea Elemento clientTarget (Esquema de configuración de ASP.NET).

Las características de ASP.NET habilitadas para Ajax son compatibles con la mayoría de los exploradores actuales y se ejecutan con la configuración de seguridad predeterminada para dichos exploradores. Estos controles y características requieren que el explorador sea capaz de ejecutar script de cliente. Los controles UpdatePanel y ScriptManager son ejemplos de controles habilitados para Ajax. Para obtener una lista de los exploradores compatibles y la configuración de seguridad recomendada para los controles y características habilitados para Ajax, vea Configuración de seguridad de exploradores en páginas ASP.NET habilitadas para AJAX.

Nota
Puede usar las propiedades que expone el objeto HttpBrowserCapabilities para determinar si un tipo de explorador admite ECMAScript (JScript, JavaScript). Sin embargo, el objeto HttpBrowserCapabilities no indica si JavaScript está habilitado para una instancia determinada de un tipo de explorador.

Para obtener información general sobre las características de Ajax en ASP.NET, vea Microsoft Ajax.

Algunas funcionalidades de los controles de servidor ASP.NET dependen de su capacidad para ejecutar scripts de cliente, que se generan automáticamente y se envían como parte de la página si el explorador tiene capacidad para ejecutarlos. Incluso en este caso, algunos usuarios podrían haber desactivado la ejecución de los scripts en su explorador, por lo que no podrían sacar el máximo partido de las posibilidades del control. Para obtener más información, vea Scripts de cliente en páginas Web ASP.NET.

Tareas

Referencia

Otros recursos