Elemento browserCaps (Esquema de configurações do ASP.NET)

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

Observação:

Usando o browserCaps elemento o arquivo Web.config definir navegadores é preterido no .NET estrutura 2.0, mas ele ainda é suportado. Os dados desse elemento são mesclados com as informações dos arquivos de definição de navegador (.browser) que estão localizadas no nível de computador %SystemRoot%\Microsoft.NET\estrutura\ versão \CONFIG\Browsers pasta e quaisquer pastas de App_Browser de 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)

<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

Elementos filho

Elementos pai

Comentários

The browserCaps elemento especifica as configurações de navegadores com suporte e os recursos para os navegadores com suporte. 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.

Linhas do formulário capsVariableName=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. O completobrowserCaps Consulte a seção, com um exemplo completo dessa sintaxe, computador. arquivo de configuração que é instalado com o .NET estrutura.

Os pares de nome/valor capturados com capsVariableName pode ser acessado por meio do Item propriedade das HttpBrowserCapabilities herdada do objeto a HttpCapabilitiesBase classe. The Item é a propriedade de indexador padrão em translation from VPE for Csharp.

Configuração padrão

No .NET estrutura versão 2.0, o seguinte padrão limitado browserCaps elemento está configurado na raiz da Web. arquivo de configuração porque ela é substituída por usando arquivos de definição de navegador para especificar recursos e navegadores com suporte. Para obter mais informações, consulte Navegador Definition arquivo esquema (browsers elemento).

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

Nas versões do .NET estrutura 1.0 e 1.1, o padrão de browserCaps elemento que está configurado no arquivo computador.config é grande demais 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 .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 HttpBrowserCapabilities objeto.

O arquivo especifica pares nome/valor na forma de instruções de atribuição, que é semelhante aos arquivos de browscap.ini do 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>
 <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

Consulte também

Tarefas

Como: Detectar tipos de navegador em páginas da Web do ASP.NET

Como: Configurar diretórios específicos usando configurações de local

Como: Bloquear ASP.NET Configuration Settings

Conceitos

Controles de Servidor Web do ASP.NET e Recursos do Navegador

Hierarquia e Herança do Arquivo de Configuração do ASP.NET

Protegendo configuração ASP.NET

Cenários de configuração ASP.NET

Referência

System.Web elemento (esquema configurações ASP.NET) 

configuração elemento (Geral Settings esquema)

Filtrar browserCaps (ASP.NET Settings esquema) elemento

Elemento de resultado para browserCaps (ASP.NET Settings esquema)

usar o elemento para browserCaps (ASP.NET Settings esquema)

Navegador Definition arquivo esquema (browsers elemento)

System.Configuration

System.Web.Configuration

HttpCapabilitiesSectionHandler

Browsers

Outros recursos

Configurações gerais (ASP.NET)

Definições de configuração ASP.NET

Administrando ites da Web do ASP.NET

API de Configuração do ASP.NET