Elemento filter para deviceFilters (Esquema de configuración de ASP.NET)

Artículo
05/27/2012

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

Proporciona funciones de filtrado para la clase MobileCapabilities.

<filter name="capability"
        compare="capabilityName"
        argument="argument" />
<filter name="capability"
        type="className"
        method="methodName" />

Atributos y elementos

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

Atributos

Atributo	Descripción
argument	Atributo String opcional. Especifica el argumento con el que se va a comparar la funcionalidad. Si se define un atributo de comparación, este atributo es necesario.
compare	Atributo String opcional. Especifica la función del explorador que el evaluador de comparaciones está evaluando. Puede tratarse de una función integrada o del nombre de cualquier otro evaluador de funciones personalizadas. Si especifica un filtro de comparación, este atributo es necesario.
method	Atributo String opcional. Especifica el método que proporciona el delegado evaluador. Se utiliza al especificar un filtro de delegado evaluador. Cuando se especifica el atributo type, este atributo es necesario y los atributos compare y argument no se pueden especificar.
name	El atributo String es obligatorio. Especifica el nombre único con el que debe identificarse al filtro. Note Un filtro que tenga el mismo nombre que un filtro definido con anterioridad (ya sea posterior en el archivo de configuración o posterior en la jerarquía de archivos de configuración) reemplaza al anterior.
type	Atributo String opcional. Especifica el tipo de clase que proporciona el delegado evaluador.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
configuration	Es el elemento raíz necesario en cada archivo de configuración que se utiliza en Common Language Runtime y las aplicaciones de .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 de configuración que configuran las aplicaciones Web ASP.NET y determinan su funcionamiento.
deviceFilters	Especifica un dispositivo o clase de dispositivo en un sistema MobileCapabilities ASP.NET basado en el agente de usuario o explorador.

Comentarios

Cuando crea una aplicación Web que tiene contenido específico del dispositivo, debe agregar uno o más filtros en una sección deviceFilters del archivo de configuración. Cada filtro determina los criterios con los que deben coincidir los dispositivos de destino.

La configuración de los filtros de dispositivos proporciona un mecanismo de evaluación para dos tipos de filtros: los filtros basados en la comparación y los filtros basados en el delegado evaluador. La sintaxis especifica ambos tipos de filtros. El primer filtro está basado en la comparación, mientras que el segundo está basado en el delegado evaluador. Para obtener una explicación detallada sobre la creación de filtros en el archivo de configuración, vea Device-Specific Rendering.

Los filtros de dispositivos hacen la distinción entre mayúsculas y minúsculas. Un filtro que se llame "isColor" y otro que se llame "IsColor" se consideran diferentes.

Configuración predeterminada

El siguiente elemento predeterminado deviceFilters no está configurado de forma explícita en el archivo de configuración del equipo o en el archivo Web.config raíz, sino que es la configuración predeterminada que devuelve una aplicación en la versión 2.0 de .NET Framework.

<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. El primer filtro muestra un filtro basado en comparación y el segundo, un filtro basado en el delegado evaluador.

<deviceFilters>
  <filter name="IsHtml" 
    compare="PreferredRendering" 
    argument="html32" />
  <filter name="IsGPSEnabled" 
    type="Application1.CapabilityEvaluators1,Application1" 
    method="IsGPSEnabled" />
</deviceFilters>

Información de elemento

Controlador de secciones de configuración	System.Web.Mobile.DeviceFiltersSection
Miembro de la configuración	SystemWebSectionGroup.DeviceFilters DeviceSpecificChoice.Filter
Ubicaciones configurables	Machine.config Web.config del nivel raíz Web.config de nivel de aplicación Web.config del nivel de directorio virtual o físico
Requisitos	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

Elemento filter para deviceFilters (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