Elemento case aplicado a filter para browserCaps (Esquema de configuración de ASP.NET)
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). |
<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. |
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 |
|
Miembro de configuración |
|
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
Tareas
Cómo: Detectar tipos y capacidades de explorador en páginas web ASP.NET
Cómo: Configurar directorios concretos mediante la configuración de la ubicación
Cómo: Bloquear los valores de configuración de ASP.NET
Referencia
Elemento filter para browserCaps (Esquema de configuración de ASP.NET)
Elemento browserCaps (Esquema de configuración de ASP.NET)
Elemento system.web (Esquema de configuración de ASP.NET)
Elemento configuration (Esquema de configuración general)
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)
HttpCapabilitiesSectionHandler
Conceptos
Controles de servidor web ASP.NET y funciones del explorador
Jerarquía de archivos y herencia de la configuración de ASP.NET
Proteger la configuración de ASP.NET
Escenarios de configuración de ASP.NET
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET