Compartilhar via


Elemento de filtro para deviceFilters (ASP.NET Settings Schema)

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

Fornece a capacidade de filtragem para o MobileCapabilities classe.

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

Attributes and Elements

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Attributes

Atributo

Descrição

argument

Opcional String atributo.

Especifica o argumento em relação à qual o recurso deve ser comparado. Se o atributo de comparação é definido, esse atributo é necessário.

compare

Opcional String atributo.

Especifica a capacidade do navegador serão avaliada pelo avaliador de comparação. O recurso pode ser qualquer recurso interno, ou o nome de qualquer outro avaliador de recurso personalizado. Se você estiver especificando um filtro de comparação, esse atributo é necessário.

method

Opcional String atributo.

Especifica o método que fornece o representante de avaliador. Usado ao especificar um filtro de delegado do avaliador. Quando o type atributo for especificado, esse atributo é necessário e o compare e argument atributos não podem ser especificados.

name

Obrigatório String atributo.

Especifica o nome exclusivo pelo qual o filtro deve ser identificado.

NoteNote
Um filtro com o mesmo nome de um filtro anteriormente definido (mais recente no arquivo de configuração ou posterior na hierarquia de arquivo de configuração) substituirá aquele definido anteriormente.

type

Opcional String atributo.

Especifica o tipo de classe que fornece o representante de avaliador.

Child Elements

Nenhum.

Parent Elements

Elemento

Descrição

configuration

O elemento raiz necessários em cada arquivo de configuração usado pelo common language runtime e.Aplicativos do NET Framework.

system.web

Especifica o elemento raiz para o ASP.Configurações de configuração de rede em um arquivo de configuração. Contém elementos de configuração que configuram aplicativos da Web ASP.NET e controla o comportamento das aplicações.

deviceFilters

Especifica um dispositivo ou uma classe de dispositivo na página ASP.NET MobileCapabilities sistema baseado no navegador ou agente do usuário.

Remarks

Ao criar um aplicativo Web que possui conteúdo de dispositivo específico, você deve adicionar um ou mais filtros em um deviceFilters seção no arquivo de configuração. Cada filtro especifica alguns critérios em relação à qual os dispositivos de destino devem ser combinados.

A configuração de filtros de dispositivo fornece um mecanismo de avaliação para dois tipos de filtros: um filtro de comparação e um filtro de delegate–based do avaliador. A sintaxe especifica os dois tipos de filtros. O primeiro filtro mostra o filtro de comparação e o segundo filtro o avaliador filtro baseadas em delegados. Para obter uma discussão detalhada sobre a criação de filtros no arquivo de configuração, consulte Device-Specific Rendering.

Filtros de dispositivo diferenciam maiúsculas de minúsculas. Um filtro chamado "isColor" e um filtro chamado "IsColor" são considerados diferentes.

Configuração padrão

O seguinte padrão deviceFilters elemento não está explicitamente configurado no arquivo de configuração de máquina ou no arquivo Web. config raiz, mas é a configuração padrão é retornada pelo aplicativo na.NET Framework versão 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>

Exemplo

O exemplo a seguir configura um filtro de comparação e um filtro de delegado do avaliador. O primeiro mostra de filtro a comparação com base em Filtrar e o segundo exibe de filtro um avaliador baseadas em delegados de filtro.

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

Element Information

Manipulador da seção de configuração

System.Web.Mobile.DeviceFiltersSection

Membro de configuração

SystemWebSectionGroup.DeviceFilters

DeviceSpecificChoice.Filter

Locais configuráveis

Machine.config

Web. config de nível de raiz.

Nível de aplicativo Web. config

Web. config de nível de diretório virtual ou física

Requisitos

IIS 5.0, IIS 5.1 ou IIS 6.0

.NET Framework 1.1 ou 2.0

2003 De Visual Studio ou Visual Studio de 2005

Consulte também

Tasks

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Reference

System. Web Element (ASP.NET Settings Schema)

configuração Element (General Settings Schema)

mobileControls Element (ASP.NET Settings Schema)

MobileCapabilities

System.Configuration

System.Web.Configuration

Concepts

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Other Resources

Using Device Filters

ASP.NET Mobile Web Pages

Creating ASP.NET Mobile Web Applications

Configurações gerais (ASP.NET)

ASP.Definições de configuração de rede

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API