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

Artículo
08/10/2011

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 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_Browsers existente del nivel de aplicación.Para obtener más información, vea Esquema de archivos de definición de explorador (Elemento browsers).

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_Browsers existente del nivel de aplicación.Para obtener más información, vea Esquema de archivos de definición de explorador (Elemento browsers).

<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

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
match	Atributo String opcional. Especifica una expresión regular .NET Framework que se comprueba con respecto al 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 .NET Framework que se comprueba con respecto al 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 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.
browserCaps	Especifica la configuración de los exploradores admitidos y sus funciones. 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 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.

browserCaps

Especifica la configuración de los exploradores admitidos y sus funciones. 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 el elemento browserCaps ha quedado desusado 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 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>

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 o 6.0 .NET Framework 2.0 (desusado), 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

Referencia

Conceptos

Otros recursos

Recursos adicionales