Podelement filter elementu browserCaps (schéma nastavení ASP.NET)

Článek
08/11/2011

Tento element určuje seznam vyhledávacích řetězců, které umožňují aplikovat individuální nastavení pro konkrétní definice prohlížečů.

Poznámka
Použití elementu browserCaps pro definici prohlížečů v souboru Web.config je v rozhraní .NET Framework 2.0 označeno jako zastaralé, avšak je nadále podporováno.Data v tomto elementu jsou sloučena s informacemi z definičních souborů prohlížeče (.browser), které jsou umístěny na úrovních počítače ve složkách %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers a na úrovni aplikace ve složkách App_Browsers.Další informace naleznete v tématu Schéma definičního souboru prohlížeče (element browsers).

Použití elementu browserCaps pro definici prohlížečů v souboru Web.config je v rozhraní .NET Framework 2.0 označeno jako zastaralé, avšak je nadále podporováno.Data v tomto elementu jsou sloučena s informacemi z definičních souborů prohlížeče (.browser), které jsou umístěny na úrovních počítače ve složkách %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers a na úrovni aplikace ve složkách App_Browsers.Další informace naleznete v tématu Schéma definičního souboru prohlížeče (element browsers).

<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>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
match	Volitelný String atributu. Určuje regulární výraz .NET Framework, který je testován vůči atributu with. Pokud je tento argument vynechán, předpokládá se úspěšná shoda.
with	Nepovinný atribut String. Určuje regulární výraz platformy .NET Framework nebo řetězec pro vyhledávání. Vynecháte-li tento parametr, je použit řetězec, který je určen elementem use.

match

Volitelný String atributu.

Určuje regulární výraz .NET Framework, který je testován vůči atributu with. Pokud je tento argument vynechán, předpokládá se úspěšná shoda.

with

Nepovinný atribut String.

Určuje regulární výraz platformy .NET Framework nebo řetězec pro vyhledávání. Vynecháte-li tento parametr, je použit řetězec, který je určen elementem use.

Podřízené prvky

Prvek	Popis
case	Umožňuje shodu se vzory pro ukončení po první úspěšné shodě mezi několika alternativami.

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element konfiguračního souboru s nastavením konfigurace technologie ASP.NET a obsahuje konfigurační prvky, které konfigurují webové aplikace ASP.NET a řídí chování aplikací.
browserCaps	Určuje nastavení podporovaných prohlížečů a schopností prohlížečů. Element browserCaps může být aktualizován v případě potřeby pro určení nových prohlížečů a jejich schopností. Seznam platných schopností prohlížeče naleznete v HttpBrowserCapabilities.

configuration

Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.

system.web

Určuje kořenový element konfiguračního souboru s nastavením konfigurace technologie ASP.NET a obsahuje konfigurační prvky, které konfigurují webové aplikace ASP.NET a řídí chování aplikací.

browserCaps

Určuje nastavení podporovaných prohlížečů a schopností prohlížečů. Element browserCaps může být aktualizován v případě potřeby pro určení nových prohlížečů a jejich schopností.

Seznam platných schopností prohlížeče naleznete v HttpBrowserCapabilities.

Poznámky

Element browserCaps určuje seznam vyhledávacích řetězců, které umožňují aplikovat individuální nastavení pro konkrétní definice prohlížečů. Pravidla, která jsou obsažena v seznamu, jsou aplikována sekvenčně. První podřízený element case, který odpovídá, je vyhodnocen a zbývající podřízené elementy case jsou ignorovány.

Výchozí konfigurace

V rozhraní .NET Framework verze 2.0 není element filter nakonfigurován, protože je element browserCaps označen jako zastaralý ve prospěch použití definičních souborů prohlížečů k určení podporovaných prohlížečů a možností prohlížečů. Další informace naleznete v tématu Schéma definičního souboru prohlížeče (element browsers).

V rozhraní .NET Framework verze 1.0 a 1.1 je prvků filter, které jsou konfigurovány v soubor Machine.config, příliš mnoho, aby byl zde uveden jejich seznam. Pro aktualizace dat prohlížeči přejděte na http://www.cyscape.com/browsercaps. Periodické aktualizace zařízení nahrazují oddíl schopností tohoto prohlížeče.

Příklad

Následující příklad kódu ukazuje, jak analyzovat hlavičku protokolu HTTP User-Agent jakékoli verze aplikace Microsoft Internet Explorer, dokud formát řetězce User-Agent zůstane přibližně nezměněn.

V příkladu využívá Regulární výrazy platformy .NET framework a schopnost regulárních výrazů zachytit podvýrazy s cílem přesunout čísla verze přímo z řetězce User-Agent do elementu browserCaps.

Soubor určuje páry název/hodnota ve formě přiřazovacího příkazu, které se podobají souborům browscap.ini Internetové informační služby (IIS). Například řádek "browser=IE" nastaví hodnotu pole prohlížeče na řetězec "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>

Informace prvku

Obslužná rutina konfiguračního oddílu	HttpCapabilitiesSectionHandler
Konfigurační člen	Browsers
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor web.config na úrovni fyzického nebo virtuálního adresáře
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 Rozhraní .NET Framework verze 2.0 (zastaralý), 1.0 nebo 1.1 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Sdílet prostřednictvím

Podelement filter elementu browserCaps (schéma nastavení ASP.NET)

Atributy a prvky

v případě vícehodnotových atributů

Podřízené prvky

Nadřazené prvky

Poznámky

Výchozí konfigurace

Příklad

Informace prvku

Viz také

Úkoly

Odkaz

Koncepty

Další zdroje

Další materiály