deviceFilters Element (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.]

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

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

Attributes and Elements

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

Attributes

Nenhum.

Child Elements

Elemento

Descrição

filter

Elemento opcional.

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

Parent Elements

Elemento

Descrição

configuration

O elemento raiz necessários em cada arquivo de configuração usado pelo common language runtime e o.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 que configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Remarks

Você pode selecionar entre 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 forem 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 do avaliador baseadas em delegados, 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 de 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 um filtro de delegado do avaliador.

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

Element Information

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

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)

Elemento de filtro para deviceFilters (ASP.NET 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