Compartir a través de


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

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

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 ha quedado desusado 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).

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

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo

Descripción

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

Este atributo es nuevo en la versión 2.0 de .NET Framework.

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.

Elementos primarios

Elemento

Descripción

configuration

Especifica el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.

system.web

Especifica el elemento raíz de los valores de configuración de ASP.NET en un archivo de configuración y contiene elementos de configuración que configuran 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 ha quedado desusado, y se usan 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 directorio virtual o físico

Requisitos

Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0

.NET Framework 2.0 (desusado), 1.1 ó 1.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

How to: Detect Browser Types in ASP.NET Web Pages

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Referencia

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

Elemento configuration (Esquema de configuración general)

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

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

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

Esquema de archivos de definición de explorador (Elemento browsers)

System.Configuration

System.Web.Configuration

HttpCapabilitiesSectionHandler

Browsers

Conceptos

ASP.NET Server Controls and Browser Capabilities

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API