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

Artículo
08/10/2011

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

Nota
La utilización del elemento browserCaps en el archivo Web.config para definir exploradores ha quedado desusado en .NET Framework 2.0; sin embargo, se admite todavía.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).

La utilización del elemento browserCaps en el archivo Web.config para definir exploradores ha quedado desusado en .NET Framework 2.0; sin embargo, se admite todavía.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).

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

Atributos y elementos

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

Atributos

Atributo	Descripción
match	El atributo String es obligatorio. 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 requerido. Especifica la expresión regular o cadena .NET Framework que se va a buscar. Si se omite, se utiliza la cadena especificada por el elemento use.

match

El atributo String es obligatorio.

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

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

Elementos secundarios

Ninguno.

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 puede actualizarse según sea necesario para especificar nuevos exploradores y funciones. Para obtener una lista de las propiedades de explorador válidas, vea HttpBrowserCapabilities.
filter	Especifica una lista de cadenas de búsqueda que permiten aplicar una configuración individual a las definiciones concretas de explorador.

Comentarios

El elemento case permite que la comprobación de modelos se detenga después de procesar la primera coincidencia entre varias alternativas.

Todos los elementos filter y case pueden contener asignaciones y otros elementos filter y case. La diferencia entre los grupos case y filter es la siguiente: después de evaluar un grupo filter, la ejecución continúa con la instrucción siguiente al grupo, mientras que después de hallar una coincidencia y evaluar un grupo case, la ejecución pasa al grupo que contiene la instrucción.

Configuración predeterminada

En .NET Framework versión 2.0, el elemento case no se configura porque el elemento browserCaps ha quedado desusado; en su lugar, se usan archivos de definición de exploradores para especificar los exploradores admitidos y sus funciones. Para obtener más información, vea Esquema de archivos de definición de explorador (Elemento browsers).

En las versiones 1.0 y 1.1 de .NET Framework, los elementos case predeterminados que se configuran en el archivo Machine.config son demasiados para enumerarlos 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 ejemplo de código siguiente se muestra cómo analizar el encabezado HTTP User-Agent de cualquier versión de Microsoft Internet Explorer, siempre que el formato de la cadena User-Agent permanezca prácticamente sin cambios.

En el ejemplo se utiliza Expresiones regulares de .NET Framework y la capacidad de las expresiones regulares para capturar subexpresiones a fin de mover 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 manera parecida a 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>
   <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) 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

Compartir a través de

Elemento case aplicado a 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