Elemento browserCaps (Esquema de configuración de ASP.NET)

Las siguientes secciones describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Elementos secundarios

Elementos primarios

El elemento browserCaps especifica la configuración y las funciones de los exploradores compatibles. El elemento browserCaps se puede actualizar según sea necesario para especificar nuevos exploradores y funciones.

Para obtener una lista de las propiedades de explorador válidas, vea HttpBrowserCapabilities.

Las líneas con el formato capsVariableName=regular expression son asignaciones. Utilice la sintaxis %{capsVariableName} o ${captureGroupName} en los atributos match y en el lado derecho de las asignaciones.

Para obtener más información sobre cómo utilizar las expresiones regulares, vea Expresiones regulares de .NET Framework. Para ver toda la sección browserCaps con un ejemplo completo de esta sintaxis, vea el archivo Machine.config que se instala con .NET Framework.

A los pares de nombre y valor capturados con capsVariableName se puede obtener acceso a través de la propiedad Item del objeto HttpBrowserCapabilities que se hereda de la clase HttpCapabilitiesBase. La propiedad Item es la propiedad de indizador predeterminada de C#.

Configuración predeterminada

---

En la versión 2.0 de .NET Framework, el siguiente elemento browserCaps predeterminado limitado se configura en el archivo Web.config raíz porque se ha dejado de usar para pasar a utilizar archivos de definición de explorador con el fin de especificar los exploradores compatibles y sus funciones. Para obtener más información, vea Esquema de archivos de definición de explorador (Elemento browsers).

Copiar

<browserCaps userAgentCacheKeyLength="64">
   <result 
      type="System.Web.Mobile.MobileCapabilities, System.Web.Mobile, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
   />
</browserCaps>

En las versiones 1.0 y 1.1 de .NET Framework, el elemento browserCaps predeterminado que se configura en el archivo Machine.config es demasiado grande para incluirlo en este documento. Para obtener las actualizaciones de los datos del explorador, visite http://www.cyscape.com/browsercaps. Las actualizaciones periódicas de dispositivos reemplazan a esta sección de funciones de explorador.

En el ejemplo de código 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 HttpBrowserCapabilities.

En el archivo se especifican 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>

Tareas

Referencia

Conceptos

Otros recursos