Filtrar elemento (ASP.NET Settings esquema) deviceFilters

Artigo
08/25/2010

Fornece a capacidade de filtragem para o MobileCapabilities classe.

configuração elemento (Geral Settings esquema)
  System.Web elemento (esquema configurações ASP.NET)
    deviceFilters elemento (esquema configurações ASP.NET)
      Filtrar elemento (ASP.NET Settings esquema) deviceFilters

<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 em relação à qual o recurso deve ser comparado. Se o atributo de comparação é definido, este atributo é necessário.
compare	Opcional String atributo. Especifica o recurso de navegador avaliado pelo avaliador de comparação. O recurso pode ser qualquer recurso interno ou o nome de qualquer Outros 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 delegado de avaliador. Usado ao especificar um filtro delegado de avaliador. Quando o type atributo for especificado, esse atributo é necessário e o compare e argument atributos não podem ser especificados.
name	Necessá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 do arquivo de configuração) substituirá aquele definido anteriormente.
type	Opcional String atributo. Especifica o tipo de classe que fornece o delegado de avaliador.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
configuration	O elemento raiz exigido em todos os arquivos de configuração usado por common linguagem tempo de execução e .NET estrutura aplicativos.
system.web	Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração. Contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.
deviceFilters	Especifica um dispositivo ou uma classe de dispositivo no ASP.NET MobileCapabilities sistema baseado em agente do usuário ou do navegador.

Comentários

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

A configuração de filtros de dispositivo fornece um mecanismo de avaliação para dois tipos de filtros: um filtro com base em comparação e um filtro de delegado–based avaliador. A sintaxe Especifica os dois tipos de filtros. O primeiro filtro mostra o filtro de comparação e o segundo filtro mostra o avaliador de filtro com base no delegado. Para obter mais informações detalhadas sobre a criação de filtros no arquivo de configuração, consulte Processamento específicas de 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á configurado explicitamente no arquivo de configuração do computador ou no arquivo Web.config raiz, mas é a configuração padrão retornada pelo aplicativo do .NET estrutura 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 delegado de avaliador. O primeiro mostra de filtro uma comparação com filtrar e segunda filtro mostra a um avaliador baseado no delegado filtrar.

<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
Configuração de membro	SystemWebSectionGroup.DeviceFilters DeviceSpecificChoice.Filter
Locais configuráveis	Machine.config Web.config de nível de raiz Nível do aplicativo Web.config Nível de diretório virtual ou físico Web.config
Requisitos	IIS 5.0, IIS 5.1 ou IIS 6.0 .NET estrutura 1.1 ou 2.0 O Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Partilhar via

Filtrar elemento (ASP.NET Settings esquema) deviceFilters

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Conceitos

Referência

Outros recursos

Recursos adicionais