deviceFilters (Elemento, 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 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.

<deviceFilters>
     <filter.../>
</deviceFilters>

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Ninguno.

Elementos secundarios

Elemento

Descripción

filter

Elemento opcional.

Proporciona funciones 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 configuración 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 siguiente ejemplo configura tanto un filtro de comparación como 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

System.Web.Mobile.DeviceFiltersSection

Configuration Member

SystemWebSectionGroup.DeviceFilters

Configurable Locations

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Web.config

Requirements

IIS 5.0, IIS 5.1 o IIS 6.0

.NET Framework 1.1 o 2.0

Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

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 deviceFilters (Esquema de configuración de ASP.NET)

mobileControls (Elemento, Esquema de configuración de ASP.NET)

MobileCapabilities

System.Configuration

System.Web.Configuration

Conceptos

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Otros recursos

Using Device Filters

ASP.NET Mobile Web Pages

Creating ASP.NET Mobile Web Applications

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API