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

Artículo
10/07/2008

Actualización: noviembre 2007

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.

Nota

El uso del elemento browserCaps en el archivo Web.config para definir los exploradores se ha dejado de utilizar en .NET Framework 2.0 pero todavía se admite. Los datos de este elemento se combinan con la información de los archivos de definición del explorador (.browser) que se encuentran en la carpeta %SystemRoot%\Microsoft.NET\Framework\versión\CONFIG\Browsers del nivel de equipo y en cualquier carpeta App_Browser existente del nivel de aplicación. Para obtener más información, vea Esquema de archivos de definición de explorador (Elemento browsers).

Elemento configuration (Esquema de configuración general)
Elemento system.web (Esquema de configuración de ASP.NET)
Elemento browserCaps (Esquema de configuración de ASP.NET)

<browserCaps>
   <result />
   <use />
   [browser capability property assignments]
   <filter>...</filter>
</browserCaps>

Atributos y elementos

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

Atributos

Atributo	Description
userAgentCacheKeyLength	Atributo String opcional. Especifica la longitud de la cadena de identificación del explorador que se utiliza como clave para almacenar los objetos de las funciones del explorador en la memoria caché interna. Para obtener más información sobre los objetos del explorador, vea Esquema de archivos de definición de explorador (Elemento browsers). Se trata de un atributo nuevo en .NET Framework, versión 2.0. El valor predeterminado es "64".

userAgentCacheKeyLength

Atributo String opcional.

Especifica la longitud de la cadena de identificación del explorador que se utiliza como clave para almacenar los objetos de las funciones del explorador en la memoria caché interna. Para obtener más información sobre los objetos del explorador, vea Esquema de archivos de definición de explorador (Elemento browsers).

Se trata de un atributo nuevo en .NET Framework, versión 2.0.

El valor predeterminado es "64".

Elementos secundarios

Elemento	Descripción
filter	Elemento opcional. Especifica una lista de cadenas de búsqueda que permiten aplicar una configuración individual a las definiciones de un explorador concreto.
result	Especifica la clase derivada de HttpCapabilitiesBase que se usa para contener los resultados del análisis de la sección browserCaps. Las funciones se almacenan como pares de cadenas de clave y valor para cada explorador. Este elemento sigue aplicándose en .NET Framework 2.0.
use	Especifica la cadena de solicitud HTTP que se utiliza para analizar la información sobre las funciones del explorador almacenada en los elementos filter y case.

filter

Elemento opcional.

Especifica una lista de cadenas de búsqueda que permiten aplicar una configuración individual a las definiciones de un explorador concreto.

result

Especifica la clase derivada de HttpCapabilitiesBase que se usa para contener los resultados del análisis de la sección browserCaps. Las funciones se almacenan como pares de cadenas de clave y valor para cada explorador.

Este elemento sigue aplicándose en .NET Framework 2.0.

use

Especifica la cadena de solicitud HTTP que se utiliza para analizar la información sobre las funciones del explorador almacenada en los elementos filter y case.

Elementos primarios

Elemento	Descripción
configuration	Especifica el elemento raíz requerido de cada archivo de configuración utilizado por Common Language Runtime y las aplicaciones de .NET Framework.
system.web	Especifica el elemento raíz de los valores de configuración ASP.NET en un archivo de configuración y contiene elementos de configuración que configuran las aplicaciones Web ASP.NET y controlan el comportamiento de las aplicaciones.

Comentarios

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=expresión regular 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).

<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.

Ejemplo

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 Microsoft Internet Information Services (IIS). Por ejemplo, la línea "browser=IE" establece como valor del campo browser la cadena "IE".

<configuration>
 <system.web>
   <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>
 </system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración	HttpCapabilitiesSectionHandler
Miembro de configuración	Browsers
Ubicaciones configurables	Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones Web.config del nivel de directorios virtuales o físicos
Requisitos	Microsoft Internet Information Services (IIS) 5.0, 5.1 ó 6.0 .NET Framework 2.0 (se ha dejado de utilizar), 1.1 ó 1.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Compartir a través de

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

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Configuración predeterminada

Ejemplo

Información de elemento

Vea también

Tareas

Conceptos

Referencia

Otros recursos

Recursos adicionales