deviceFilters Element (ASP.NET Settings Schema)

Especifica um dispositivo ou uma classe de dispositivo no ASP.NET MobileCapabilities sistema baseado em agente de usuário ou navegador. Um filtro de dispositivo pode ser usado por um desenvolvedor de página ou aplicativo para substituir as propriedades de controle ou para definir blocos de conteúdo ou modelos que alterar o layout e aparência.

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

Atributos e elementos

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

Atributos

Nenhum.

Elementos filho

Elemento

Descrição

filter

Elemento opcional.

Fornece a capacidade de filtragem para o MobileCapabilities classe. Pode haver um ou mais elementos de filtro no <deviceFilters> seção.

Elementos pai

Elemento

Descrição

configuration

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

system.web

Especifica o elemento raiz para o ASP.Definições de configuração de rede em um arquivo de configuração. Contém elementos que configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Comentários

Você pode selecionar dois tipos de filtros de dispositivo: avaliadores de comparação ou delegados do avaliador.

Para comparações simples, você pode especificar um filtro de comparação, fornecendo o nome de um recurso e um valor para comparação. Em tempo de execução, o filtro do dispositivo é avaliada como true se o valor de recurso e o valor fornecido são iguais. Comparações de propriedade booleana diferenciam maiúsculas de minúsculas; Portanto, true e True são ambos válidos. Outras comparações de propriedade diferenciam maiúsculas de minúsculas.

Para uma avaliação mais complexa, você pode especificar um filtro com o representante de avaliador, fornecendo o nome da classe e método de um método. Em tempo de execução, o método fornecido é chamado para determinar se o filtro do dispositivo é avaliada como true.

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 de um filtro de delegado do avaliador.

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

Informações do elemento

Configuration Section Handler

System.Web.Mobile.DeviceFiltersSection

Configuration Member

SystemWebSectionGroup.DeviceFilters

Configurable Locations

Machine.config

Web. config de nível de raiz.

Web. config de nível de aplicativo

Web.config

Requirements

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

Tarefas

Como: Configurar Diretórios Específicos Usando Configurações por Localização

Como: Bloquear definições de configuração ASP.NET

Referência

system.web Element (ASP.NET Settings Schema)

configuração Element (Geral Configurações Schema)

Elemento de filtro para deviceFilters (ASP.NET Configurações Schema)

mobileControls Element (ASP.NET Settings Schema)

MobileCapabilities

System.Configuration

System.Web.Configuration

Conceitos

Hierarquia e Herança do Arquivo de Configuração do ASP.NET

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

Using Device Filters

ASP.NET Mobile Web Pages

Criando aplicativos ASP.Páginas da Web de NET Mobile

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

Administração de Sites do ASP.NET

Arquivos de configuração ASP.NET

API de Configuração do ASP.NET