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 |
|
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) 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)
HttpCapabilitiesSectionHandler
Conceptos
ASP.NET Server Controls and Browser Capabilities
ASP.NET Configuration File Hierarchy
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET