deviceFilters (Elemento, Esquema de configuración de ASP.NET)
Actualización: noviembre 2007
Especifica un dispositivo o clase de dispositivo en un sistema MobileCapabilities ASP.NET basado en el agente de usuario o explorador. Un programador de páginas o aplicaciones puede utilizar un filtro de dispositivo para reemplazar propiedades del control o definir bloques de contenido o plantillas que cambian el diseño y la apariencia.
Elemento configuration (Esquema de configuración general)
Elemento system.web (Esquema de configuración de ASP.NET)
deviceFilters (Elemento, Esquema de configuración de ASP.NET)
<deviceFilters>
<filter.../>
</deviceFilters>
Atributos y elementos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
Atributos
Ninguno.
Elementos secundarios
Elemento |
Descripción |
|---|---|
filter |
Elemento opcional. Proporciona la función de filtrado para la clase MobileCapabilities. Puede haber uno o más elementos de filtro en la sección <deviceFilters>. |
Elementos primarios
Elemento |
Descripción |
|---|---|
configuration |
Elemento raíz necesario en cada archivo de configuración utilizado por las aplicaciones Common Language Runtime y .NET Framework. |
system.web |
Especifica el elemento raíz de las opciones de ASP.NET en un archivo de configuración. Contiene los elementos que configuran las aplicaciones Web ASP.NET y determinan su funcionamiento. |
Comentarios
Se puede elegir entre dos tipos de filtros de dispositivo: evaluadores de comparaciones o delegados evaluadores.
En comparaciones simples, se puede especificar un filtro basado en la comparación proporcionando el nombre de una función y un valor con el que se ha de efectuar la comparación. En tiempo de ejecución, el filtro de dispositivo se evalúa como true si el valor de la función y el valor suministrado son iguales. Las propiedades Boolean se comparan sin distinción entre mayúsculas y minúsculas; por consiguiente, true y True son ambos válidos. Al comparar otras propiedades se distingue entre mayúsculas y minúsculas.
Para las evaluaciones más complejas, se puede especificar un filtro basado en el delegado evaluador proporcionando el nombre de clase y método de un método. En tiempo de ejecución, se llama al método proporcionado para determinar si el filtro de dispositivo se evalúa como true.
Configuración predeterminada
El siguiente elemento <deviceFilters> predeterminado no está configurado explícitamente en el archivo de configuración del equipo ni en el archivo Web.config raíz, pero es la configuración predeterminada que devuelve la aplicación en .NET Framework versión 2.0.
<deviceFilters>
<filter name="isJPhone" compare="Type" argument="J-Phone"/>
<filter name="isHTML32" compare="PreferredRenderingType" argument="html32"/>
<filter name="isWML11" compare="PreferredRenderingType" argument="wml11"/>
<filter name="isCHTML10" compare="PreferredRenderingType" argument="chtml10"/>
<filter name="isGoAmerica" compare="Browser" argument="Go.Web"/>
<filter name="isMME" compare="Browser" argument="Microsoft Mobile Explorer"/>
<filter name="isMyPalm" compare="Browser" argument="MyPalm"/>
<filter name="isPocketIE" compare="Browser" argument="Pocket IE"/>
<filter name="isUP3x" compare="Type" argument="Phone.com 3.x Browser"/>
<filter name="isUP4x" compare="Type" argument="Phone.com 4.x Browser"/>
<filter name="isEricssonR380" compare="Type" argument="Ericsson R380"/>
<filter name="isNokia7110" compare="Type" argument="Nokia 7110"/>
<filter name="prefersGIF" compare="PreferredImageMIME" argument="image/gif"/>
<filter name="prefersWBMP" compare="PreferredImageMIME" argument="image/vnd.wap.wbmp"/>
<filter name="supportsColor" compare="IsColor" argument="true"/>
<filter name="supportsCookies" compare="Cookies" argument="true"/>
<filter name="supportsJavaScript" compare="Javascript" argument="true"/>
<filter name="supportsVoiceCalls" compare="CanInitiateVoiceCall" argument="true"/>
</deviceFilters>
Ejemplo
El ejemplo siguiente configura un filtro de comparación y un filtro de delegado evaluador.
<deviceFilters>
<filter name="IsHtml"
compare="PreferredRendering"
argument="html32" />
<filter name="IsGPSEnabled"
type="MyApplication.MyCapabilityEvaluators,MyApplication"
method="IsGPSEnabled" />
</deviceFilters>
Información de elemento
Configuration Section Handler |
|
Configuration Member |
|
Configurable Locations |
Machine.config Web.config del nivel de raíz Web.config del nivel de aplicación Web.config |
Requirements |
IIS 5.0, IIS 5.1 o IIS 6.0 .NET Framework 1.1 ó 2.0 Visual Studio 2003 o Visual Studio 2005 |
Vea también
Tareas
Cómo: Configurar directorios concretos mediante la configuración de la ubicación
Cómo: Bloquear los valores de configuración de ASP.NET
Conceptos
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
Referencia
Elemento system.web (Esquema de configuración de ASP.NET)
Elemento configuration (Esquema de configuración general)
Elemento filter para deviceFilters (Esquema de configuración de ASP.NET)
mobileControls (Elemento, Esquema de configuración de ASP.NET)
Otros recursos
Utilizar filtros de dispositivo
Crear páginas Web de ASP.NET Mobile
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET
Administrar sitios web ASP.NET