Filtrar browserCaps (ASP.NET Settings esquema) elemento

Artigo
08/25/2010

Este elemento especifica uma lista de seqüências de Pesquisar que lhe permitem aplicar configurações individuais em definições de navegador específico.

Observação:
Usando o browserCaps elemento no arquivo Web.config para definir navegadores é substituído no .NET estrutura versão 2.0; no entanto, ele ainda é suportado. Os dados desse elemento são mesclados com as informações de arquivos de definição do navegador (.browser) localizados no nível de computador %SystemRoot%\Microsoft.NET\estrutura\ versão \CONFIG\Browsers pasta e quaisquer pastas de App_Browsers do nível de aplicativo existentes. Para obter mais informações, consulte Navegador Definition arquivo esquema (browsers elemento).

Usando o browserCaps elemento no arquivo Web.config para definir navegadores é substituído no .NET estrutura versão 2.0; no entanto, ele ainda é suportado. Os dados desse elemento são mesclados com as informações de arquivos de definição do navegador (.browser) localizados no nível de computador %SystemRoot%\Microsoft.NET\estrutura\ versão \CONFIG\Browsers pasta e quaisquer pastas de App_Browsers do nível de aplicativo existentes. Para obter mais informações, consulte Navegador Definition arquivo esquema (browsers elemento).

configuração elemento (Geral Settings esquema)
  System.Web elemento (esquema configurações ASP.NET)
    Elemento browserCaps (Esquema de configurações do ASP.NET)
      Filtrar browserCaps (ASP.NET Settings esquema) elemento

<filter> 
   [assignments, filter elements and case elements]
<filter>
<filter 
   match="[regular expression]" 
   with="[regular expression]" >
   [browser capability assignments, filter elements, case elements]
</filter>
<filter>
   <case>...</case>
</filter>

Atributos e elementos

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

Atributos

Atributo	Descrição
match	Opcional String atributo. Especifica uma expressão regular do .NET estrutura testada com o with atributo. Se omitido, a correspondência é considerada bem-sucedida.
with	Opcional String atributo. Especifica uma expressão regular do .NET estrutura ou seqüência de caracteres Pesquisar. Se omitido, a seqüência de caracteres que é especificada pelo use elemento é usado.

match

Opcional String atributo.

Especifica uma expressão regular do .NET estrutura testada com o with atributo. Se omitido, a correspondência é considerada bem-sucedida.

with

Opcional String atributo.

Especifica uma expressão regular do .NET estrutura ou seqüência de caracteres Pesquisar. Se omitido, a seqüência de caracteres que é especificada pelo use elemento é usado.

Elementos filho

Elemento	Descrição
case	Permite a correspondência de padrões parar após a primeira correspondência bem-sucedida check-out de um número de alternativas de processamento.

Elementos pai

Elemento	Descrição
configuration	Especifica o elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura.
system.web	Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração e contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.
browserCaps	Especifica as configurações de navegadores com suporte e os recursos para os navegadores. The browserCaps elemento pode ser atualizado conforme necessário, para especificar novos navegadores e recursos. Para obter uma lista de propriedades de navegador válidas, consulte HttpBrowserCapabilities.

configuration

Especifica o elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura.

system.web

Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração e contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.

browserCaps

Especifica as configurações de navegadores com suporte e os recursos para os navegadores. The browserCaps elemento pode ser atualizado conforme necessário, para especificar novos navegadores e recursos.

Para obter uma lista de propriedades de navegador válidas, consulte HttpBrowserCapabilities.

Comentários

The browserCaps elemento especifica uma lista de seqüências de Pesquisar que lhe permitem aplicar configurações individuais em definições de navegador específico. As regras que estão contidas na lista são aplicadas em sequência. O primeiro filho case elemento que é avaliada correspondências e o filho restante case elementos serão ignorados.

Configuração padrão

No .NET estrutura versão 2.0, a filter elemento não está configurado porque o browserCaps elemento é substituído por usando arquivos de definição de navegador para especificar a navegadores com suporte e os recursos para os navegadores. Para obter mais informações, consulte Navegador Definition arquivo esquema (browsers elemento).

Nas versões do .NET estrutura 1.0 e 1.1, o padrão de filter elementos que estão configurados no arquivo computador.config são muito numerosas para serem listadas aqui. Para atualizações nos dados de navegador, vá para http://www.cyscape.com/browserCaps. Atualizações periódicas dispositivo substituírem esta seção de recursos do navegador.

Exemplo

O exemplo de código a seguir demonstra sistema autônomo analisar o User-Agent Cabeçalho HTTP para qualquer versão do Microsoft Internet Explorer, contanto que o formato das User-Agent seqüência de caracteres permanece inalterada aproximadamente.

O exemplo usa o .NET estrutura Regular Expressions e a capacidade de capturar subexpressions para mover números de versão diretamente do de expressões regularesUser-Agent string para o browserCaps elemento.

O arquivo especifica pares nome/valor na forma de instruções de atribuição, que são os arquivos browscap.ini Serviços de Informações da Internet da Microsoft (IIS). Por exemplo, a linha "browser=IE" Define o valor do campo de navegador para a seqüência de caracteres "IE".

<configuration>
   <browserCaps>
      <result type="System.Web.HttpBrowserCapabilities, System.Web"/>
      <use var="HTTP_USER_AGENT"/>
      browser=Unknown
      version=0.0
      majorversion=0
      minorversion=0
      frames=false
      tables=false
      cookies=false
      backgroundsounds=false
      <filter>
         <case match="^Mozilla[^(]*\(compatible; MSIE 
            (?'ver'(?'major'\d+)(?'minor'\.\d+)(?'letters'\w*))
            (?'extra'.*)">
            browser=IE
            version=${ver}
            majorver=${major}
            minorver=${minor}
            <case match="^2\." with="%{version}">
               tables=true
               cookies=true
               backgroundsounds=true
               <case match="2\.5b" with="%{version}">
                  beta=true
               </case>
            </case>
         </case>
      </filter>
   </browsercaps>
</configuration>

Informações do elemento

Manipulador de seção de configuração	HttpCapabilitiesSectionHandler
Configuração de membro	Browsers
Locais configuráveis	Machine.config Web.config de nível de raiz Web.config de nível de aplicativo Virtual ou físico diretório–nível Web.config
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0 The .NET Framework version 2.0 (deprecated), 1.0, or 1.1 Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Partilhar via

Filtrar browserCaps (ASP.NET Settings esquema) elemento

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