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
Atributo |
Descrição |
---|---|
userAgentCacheKeyLength |
Opcional String atributo. Especifica o comprimento da seqüência de caracteres de identificação do navegador para usar sistema autônomo a chave para cache de objetos de recursos de navegador no cache interno. Para obter mais informações sobre objetos de recursos do navegador, consulte Navegador Definition arquivo esquema (browsers elemento). Esse atributo é novo no .NET estrutura versão 2.0. O padrão é "64". |
Elementos filho
Elemento |
Descrição |
---|---|
filter |
Elemento opcional. Especifica uma lista de seqüências de Pesquisar que permitem aplicar configurações individuais para as definições de navegador específico. |
result |
Especifica o HttpCapabilitiesBase-derivada da classe que é usada para Isenção dos resultados da análise do browserCaps seção. sistema autônomo recursos são armazenados sistema autônomo pares de seqüência de caracteres para cada localizador de chave/valor. Esse elemento ainda aplica no .NET estrutura versão 2.0. |
use |
Especifica a seqüência de solicitação HTTP para usar para analisar as capacidade de navegador as informações armazenadas no filter e case elementos. |
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. |
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
Manipulador de seção de configuração |
|
Configuração de membro |
|
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 O .NET estrutura versão 2.0 (obsoleto), 1.1 ou 1.0 Microsoft Visual Studio 2003 ou o Visual Studio 2005 |
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)
HttpCapabilitiesSectionHandler
Outros recursos
Configurações gerais (ASP.NET)
Definições de configuração ASP.NET