Elemento <browserCaps>

Configura las opciones del componente de funcionalidad del explorador. El elemento <browserCaps> puede declararse en los equipos, sitios, aplicaciones y subdirectorios. El elemento <browserCaps> puede actualizarse cuando sea necesario para que detecte futuros exploradores y nueva funcionalidad.

En la descripción de la clase HttpBrowserCapabilities encontrará una lista de propiedades de explorador válidas.

<configuration>
   <system.web>
**      <browserCaps>**

<browserCaps>
   <result type="class"/>   <use var="HTTP_USER_AGENT"/>        browser=Unknown
        version=0.0
        majorver=0
        minorver=0
        frames=false
        tables=false
      <filter>         <case match="Windows 98|Win98">
            platform=Win98
         </case>      <case match="Windows NT|WinNT">
         platform=WinNT
      </case>   </filter>   <filter match="Unknown" with="%(browser)">
      <filter match="Win95" with="%(platform)">
      </filter>   </filter></browserCaps>

Subetiquetas

Subetiqueta	Descripción
<use>	Especifica las variables del servidor que se utilizan cuando se evalúa <filter>, <case> y las asignaciones de la sección.
<filter>	Evalúa el primer elemento <case> secundario coincidente y omite el resto.
<result>	Especifica la clase derivada de HttpCapabilitiesBase utilizada para almacenar los pares de cadenas de clave y valor resultantes del análisis de esta sección (por ejemplo, browser, version, o majorver en el bloque de sintaxis anterior). Esta cadena se utiliza en tiempo de ejecución para crear el tipo devuelto.

Comentarios

Las líneas con el formato capsVariableName=expresión regular son asignaciones. Utilice la sintaxis %{capsVariableName} o ${captureGroupName} en los atributos match y en el término de la derecha de las asignaciones. Para obtener más información sobre cómo usar las expresiones regulares, vea Expresiones regulares de .NET Framework. Para ver toda la sección <browserCaps> con un ejemplo más completo de esta sintaxis, vea el archivo Machine.config que se instala con .NET Framework.

Los pares de nombre y valor capturados con capsVariableName pueden obtenerse a través de la propiedad Item de la clase HttpBrowserCapabilities que se hereda de HttpCapabilitiesBase. La propiedad Item es el indizador predeterminado de C#.

Ejemplo

En el ejemplo siguiente se muestra cómo se analiza el encabezado HTTP User-Agent para cualquier versión de Internet Explorer (siempre que el formato de la cadena User-Agent se mantenga sin cambios importantes).

En el ejemplo se utilizan expresiones regulares de .NET Framework y se aprovecha su capacidad para capturar subexpresiones con el fin de pasar los números de versión directamente desde la cadena User-Agent al objeto de funcionalidad del explorador.

El archivo especifica los pares de nombre y valor en forma de instrucciones de asignación, de modo similar a como se hace en los archivos browscap.ini de los Servicios de Microsoft Internet Information Server (IIS). Por ejemplo, la línea "browser=IE" establece como valor del campo browser la cadena "IE".

<configuration>
   <browserCaps>
      <result type="System.Web.HttpBrowserCapabilities, System.Web"/>
      <use var="HTTP_USER_AGENT"/>
      browser=Unknown
      version=0.0
      majorversion=0
      minorversion=0
      frames=false
      tables=false
      cookies=false
      backgroundsounds=false
      <filter>
         <case match="^Mozilla[^(]*\(compatible; MSIE 
            (?'ver'(?'major'\d+)(?'minor'\.\d+)(?'letters'\w*))
            (?'extra'.*)">
            browser=IE
            version=${ver}
            majorver=${major}
            minorver=${minor}
            <case match="^2\." with="%{version}">
               tables=true
               cookies=true
               backgroundsounds=true
               <case match="2\.5b" with="%{version}">
                  beta=true
               </case>
            </case>
         </case>
      </filter>
   </browsercaps>
</configuration>

Requisitos

Contenido dentro de: <system.web>

Plataforma Web: IIS 5.0, IIS 5.1, IIS 6.0

Archivo de configuración: Machine.config, Web.config

Controlador de la sección de configuración: System.Web.Configuration.HttpCapabilitiesSectionHandler

Vea también

Configuración de ASP.NET | Esquema de configuración de ASP.NET