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

Artículo
10/07/2008

Actualización: noviembre 2007

Este elemento especifica una lista de cadenas de búsqueda que permiten aplicar valores de configuración individuales a definiciones de explorador específicas.

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_Browsers 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)
      Elemento filter para browserCaps (Esquema de configuración de ASP.NET)

<filter> 
   [assignments, filter elements and case elements]
<filter>
<filter 
   match="[regular expression]" 
   with="[regular expression]" >
   [browser capability assignments, filter elements, case elements]
</filter>
<filter>
   <case>...</case>
</filter>

Atributos y elementos

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

Atributos

Atributo	Descripción
match	Atributo String opcional. Especifica una expresión regular de .NET Framework que se comprueba con el atributo with. Si se omite, se considera que hay coincidencia.
with	Atributo String opcional. Especifica una expresión regular de .NET Framework o cadena que se va a buscar. Si se omite, se utiliza la cadena especificada por el elemento use.

match

Atributo String opcional.

Especifica una expresión regular de .NET Framework que se comprueba con el atributo with. Si se omite, se considera que hay coincidencia.

with

Atributo String opcional.

Especifica una expresión regular de .NET Framework o cadena que se va a buscar. Si se omite, se utiliza la cadena especificada por el elemento use.

Elementos secundarios

Elemento	Descripción
case	Permite que la comprobación de modelos se detenga después de procesar la primera coincidencia entre varias alternativas.

Elementos primarios

Elemento	Descripción
configuration	Especifica el elemento raíz requerido en cada archivo de configuración usado 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.
browserCaps	Especifica los valores de configuración y las funciones de los exploradores compatibles. El elemento browserCaps se puede actualizar según sea necesario para especificar nuevos exploradores y sus funciones. Para obtener una lista de las propiedades de explorador válidas, vea HttpBrowserCapabilities.

configuration

Especifica el elemento raíz requerido en cada archivo de configuración usado 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.

browserCaps

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

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

Comentarios

El elemento browserCaps especifica una lista de cadenas de búsqueda que permiten aplicar valores de configuración individuales a definiciones de explorador específicas. Las reglas incluidas en la lista se aplican por orden. Se evalúa el primer elemento case secundario coincidente y se omiten los restantes elementos case secundarios.

Configuración predeterminada

En .NET Framework 2.0, el elemento filter no está configurado porque se ha dejado de utilizar el elemento browserCaps y se usan archivos de definición de explorador para especificar los exploradores compatibles y sus funciones. Para obtener más información, vea Esquema de archivos de definición de explorador (Elemento browsers).

En .NET Framework 1.0 y 1.1, la lista de los elementos filter configurados en el archivo Machine.config es demasiado exhaustiva para reflejarla aquí. 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 siguiente ejemplo de código se muestra cómo se analiza el encabezado HTTP User-Agent para cualquier versión de Microsoft Internet Explorer, siempre que el formato de la cadena User-Agent se mantenga sin cambios importantes.

En este ejemplo se utilizan las expresiones regulares de .NET Framework y se e aprovecha su capacidad para capturar subexpresiones con el fin de pasar los números de versión directamente desde la cadena User-Agent al elemento browserCaps.

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

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) versión 5.0, 5.1 o 6.0 .NET Framework 2.0 (en desuso), 1.0 ó 1.1 Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Compartir a través de

Elemento filter para 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