Caso o elemento para o filtro de browserCaps (ASP.NET Configurações Schema)

Artigo
08/04/2011

Permite a correspondência de padrões parar após o processamento da primeira correspondência bem-sucedida entre diversas alternativas.

Observação

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

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

Atributos e elementos

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

Atributos

Atributo	Descrição
match	Obrigatório 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	Obrigatório String atributo. Especifica o.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.

match

Obrigatório 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

Obrigatório String atributo.

Especifica o.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.

Elementos filho

Nenhum.

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.
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 novos navegadores e recursos. Para obter uma lista das propriedades de navegador válidas, consulte HttpBrowserCapabilities.
filter	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.

Comentários

O case elemento permite a correspondência de padrões para parar após o processamento da primeira correspondência bem-sucedida entre um número de alternativas.

Todos os filter e case elementos podem conter atribuições e outros filter e case elementos. A diferença entre case e filter grupos é esta: Após um filter grupo é avaliado, a execução continua com a instrução após o grupo, mas após um case grupo é correspondido com êxito e avaliadas, ignora a execução para o fim do grupo delimitador.

Configuração padrão

No.NET Framework versão 2.0, o case 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 Definição Arquivo Schema (browsers Element).

No.NET Framework versões 1.0 e 1.1, o padrão case elementos que são configurados no arquivo Machine. config são muito numerosas para 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 o Expressões Regulares do .NET Framework 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 é 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>
   <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 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

Caso o elemento para o filtro de browserCaps (ASP.NET Configurações 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