browserCaps Element (ASP.NET Settings Schema)

Artigo
08/04/2011

Especifica as configurações de navegadores suportados e os recursos dos navegadores aceitos. O browserCaps elemento pode ser atualizado conforme necessário para especificar os novos navegadores e recursos.

Observação

Usando o browserCaps o elemento no arquivo Web. config para definir navegadores é substituído na.NET Framework 2.0, mas ele ainda é suportado.Os dados nesse elemento são mesclados com as informações de arquivos de definição de navegador (browser) estão localizadas em %SystemRoot%\Microsoft.NET\Framework\ o nível de máquinaversãopasta de \config\browsers e quaisquer pastas App_Browser de nível de aplicativo existentes.Para obter mais informações, consulte Browser Definição Arquivo Schema (browsers Element).

<browserCaps>
   <result />
   <use />
   [browser capability property assignments]
   <filter>...</filter>
</browserCaps>

Atributos e elementos

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

Atributos

Atributo	Descrição
userAgentCacheKeyLength	Opcional String atributo. Especifica o comprimento da seqüência de caracteres de identificação do navegador para usar como chave para o cache de objetos de recursos do navegador no cache interno. Para obter mais informações sobre objetos de recursos do navegador, consulte Browser Definição Arquivo Schema (browsers Element). Esse atributo é novo na.NET Framework versão 2.0. O padrão é "64".

userAgentCacheKeyLength

Opcional String atributo.

Especifica o comprimento da seqüência de caracteres de identificação do navegador para usar como chave para o cache de objetos de recursos do navegador no cache interno. Para obter mais informações sobre objetos de recursos do navegador, consulte Browser Definição Arquivo Schema (browsers Element).

Esse atributo é novo na.NET Framework versão 2.0.

O padrão é "64".

Elementos filho

Elemento	Descrição
filter	Elemento opcional. Especifica uma lista de seqüências de caracteres de pesquisa que permitem que você aplique configurações individuais para definições de navegador específico.
result	Especifica o HttpCapabilitiesBase-derivada da classe é usada para manter os resultados da análise de browserCaps seção. Os recursos são armazenados como pares de seqüência de caracteres para cada navegador chave/valor. Este elemento ainda se aplica a.NET Framework versão 2.0.
use	Especifica a seqüência de solicitação HTTP para usar para analisar as informações de recurso do navegador são armazenadas nas filter e case elementos.

filter

Elemento opcional.

Especifica uma lista de seqüências de caracteres de pesquisa que permitem que você aplique configurações individuais para definições de navegador específico.

result

Especifica o HttpCapabilitiesBase-derivada da classe é usada para manter os resultados da análise de browserCaps seção. Os recursos são armazenados como pares de seqüência de caracteres para cada navegador chave/valor.

Este elemento ainda se aplica a.NET Framework versão 2.0.

use

Especifica a seqüência de solicitação HTTP para usar para analisar as informações de recurso do navegador são armazenadas nas filter e case elementos.

Elementos pai

Elemento	Descrição
configuration	Especifica o elemento raiz necessários em cada arquivo de configuração que é 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 uma configuração de arquivo e contém elementos de configuração para configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Comentários

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

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

Linhas do formulário capsVariableName=a expressão regular são atribuições. Use a sintaxe %{capsVariableName} ou ${captureGroupName} em match atributos e no lado direito das atribuições.

Para obter mais informações sobre como usar expressões regulares, consulte Expressões Regulares do .NET Framework. Para o total seçãobrowserCaps , com um exemplo completo dessa sintaxe, consulte o arquivo Machine. config que é instalado com o.NET Framework.

Os pares nome/valor que são capturados com capsVariableName podem ser acessados através do Item propriedade do HttpBrowserCapabilities objeto é herdado do HttpCapabilitiesBase classe. O Item é a propriedade do indexador padrão em C#.

Configuração padrão

No.NET Framework versão 2.0, o seguinte limitado padrão browserCaps elemento é configurado no arquivo Web. config raiz porque ele é preterido em favor do uso de arquivos de definição de navegador para especificar os navegadores com suporte e recursos. Para obter mais informações, consulte Browser Definição Arquivo Schema (browsers Element).

<browserCaps userAgentCacheKeyLength="64">
   <result 
      type="System.Web.Mobile.MobileCapabilities, System.Web.Mobile, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
   />
</browserCaps>

No.NET Framework versões 1.0 e 1.1, o padrão browserCaps o elemento que é configurado no arquivo Machine. config é muito grande para a lista aqui. Para atualizações para os dados do navegador, vá para http://www.cyscape.com/browsercaps. Atualizações periódicas de dispositivo substituem esta seção de recursos do navegador.

Exemplo

O exemplo de código a seguir demonstra como analisar a User-Agent qualquer versão do Microsoft Internet Explorer, desde que o formato do cabeçalho HTTP do User-Agent seqüência permanece quase inalterada.

O exemplo usa .NET Framework Regular Expressions e a capacidade de capturar subexpressões para mover os números de versão diretamente a partir de expressões regulares a User-Agent string para o HttpBrowserCapabilities objeto.

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

<configuration>
 <system.web>
   <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>
 </system.web>
</configuration>

Informações do elemento

Manipulador da seção de configuração	HttpCapabilitiesSectionHandler
Membro de configuração	Browsers
Locais configuráveis	Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Virtual ou física directory–level Web. config
Requisitos	De da (IIS) versão 5.0, 5.1 ou 6.0 A.NET Framework versão 1.0, 1.1 ou 2.0 (obsoleto) Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Compartilhar via

browserCaps Element (ASP.NET Settings Schema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais