Partilhar via


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

Fornece a capacidade de filtragem para o MobileCapabilities classe.

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

Atributos e elementos

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

Atributos

Atributo

Descrição

argument

Opcional String atributo.

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

compare

Opcional String atributo.

Especifica a capacidade de navegador avaliada pelo avaliador de comparação. O recurso pode ser qualquer recurso interno ou o nome do 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.

Observação

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.

Elementos filho

Nenhum.

Elementos pai

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.Definiçõ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 no ASP.NET MobileCapabilities sistema baseado em agente de usuário ou navegador.

Comentários

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

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 Processamento específico do dispositivo.

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 de um filtro de delegado do avaliador. Primeira filtro mostra a uma base de comparação de filtro e o segunda filtro mostra a 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>

Informações do elemento

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

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)

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