Filtrar elemento browserCaps (ASP.NET Settings Schema)
[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]
Este elemento Especifica uma lista de seqüências de pesquisa que permitem que você aplique configurações individuais para definições de navegador específico.
Observação
Usando o browserCaps elemento no arquivo Web. config para definir navegadores é substituído na.NET Framework versão 2.0; No entanto, ele ainda é suportado.Os dados nesse elemento são mesclados com as informações de arquivos de definição de navegador (. browser) localizados em %SystemRoot%\Microsoft.NET\Framework\ o nível de máquinaversãopasta \CONFIG\Browsers e quaisquer pastas existentes de App_Browsers do nível do aplicativo.Para obter mais informações, consulte Browser Definition File Schema (browsers Element).
<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>
Attributes and Elements
As seções a seguir descrevem atributos, elementos filho, e elementos pai.
Attributes
Atributo |
Descrição |
|---|---|
match |
Opcional String atributo. Especifica um.Expressão regular do NET Framework que está sendo testado em relação a with atributo. Se omitido, a correspondência é considerada bem-sucedido. |
with |
Opcional String atributo. Especifica um.Expressão regular do NET Framework ou seqüência de caracteres para pesquisar. Se omitido, a seqüência de caracteres especificado pelo use elemento é usado. |
Child Elements
Elemento |
Descrição |
|---|---|
case |
Permite a correspondência de padrões parar após o processamento da primeira correspondência bem-sucedida entre diversas alternativas. |
Parent Elements
Elemento |
Descrição |
|---|---|
configuration |
Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e o.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 que configurar aplicativos ASP.NET e controlar como os aplicativos se comportam. |
browserCaps |
Especifica as configurações de navegadores suportados e os recursos para os navegadores. O browserCaps elemento pode ser atualizado conforme necessário, para especificar os recursos e os novos navegadores. Para obter uma lista das propriedades de navegador válidas, consulte HttpBrowserCapabilities. |
Remarks
O browserCaps elemento Especifica uma lista de seqüências de pesquisa que permitem que você aplique configurações individuais para definições de navegador específico. As regras que estão contidas na lista são aplicadas em seqüência. O primeiro filho case elemento que correspondências é avaliada e o filho restante case elementos serão ignorados.
Configuração padrão
No.NET Framework versão 2.0, o filter elemento não está configurado porque a browserCaps elemento é preterido em favor do uso de arquivos de definição de navegador para especificar os navegadores com suporte e os recursos para os navegadores. Para obter mais informações, consulte Browser Definition File Schema (browsers Element).
No.NET Framework versões 1.0 e 1.1, o padrão filter elementos que são configurados no arquivo Machine. config são muito numerosas para listar aqui. Para atualizações dos 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 cabeçalho HTTP para qualquer versão do Microsoft Internet Explorer, desde que o formato da User-Agent seqüência permanece quase inalterada.
O exemplo usa a .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 browserCaps elemento.
O arquivo Especifica pares nome/valor na forma de instruções de atribuição, que são semelhantes a 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>
<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>
Element Information
Manipulador da seção de configuração |
|
Membro de configuração |
|
Locais configuráveis |
Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Directory–level virtuais ou físicas Web. config |
Requisitos |
Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0 A.NET Framework versão 2.0 (obsoleto), 1.0 ou 1.1 Microsoft Visual Studio 2003 ou 2005 de Visual Studio |
Consulte também
Tasks
How to: Detect Browser Types in ASP.NET Web Pages
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Reference
browserCaps Element (ASP.NET Settings Schema)
Caso o elemento para o filtro de browserCaps (ASP.NET Settings Schema)
System. Web Element (ASP.NET Settings Schema)
configuração Element (General Settings Schema)
Elemento de resultado para browserCaps (ASP.NET Settings Schema)
usar o elemento para browserCaps (ASP.NET Settings Schema)
Browser Definition File Schema (browsers Element)
HttpCapabilitiesSectionHandler
Concepts
ASP.NET Server Controls and Browser Capabilities
ASP.NET Configuration File Hierarchy
Other Resources
Configurações gerais (ASP.NET)
ASP.Definições de configuração de rede