Element browserCaps (schéma nastavení ASP.NET)

Článek
08/11/2011

Určuje nastavení podporovaných prohlížečů a schopností podporovaných 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í.

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_Browser.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_Browser.Další informace naleznete v tématu Schéma definičního souboru prohlížeče (element browsers).

<browserCaps>
   <result />
   <use />
   [browser capability property assignments]
   <filter>...</filter>
</browserCaps>

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
userAgentCacheKeyLength	Volitelný String atributu. Určuje délku identifikačního řetězce prohlížeče, který chcete použít jako klíč pro objekty schopností mezipaměti prohlížeče v interní mezipaměti. Další informace o objektech schopností prohlížeče naleznete v tématu Schéma definičního souboru prohlížeče (element browsers). Tento atribut je v rozhraní .NET Framework verze 2.0 nový. Výchozí hodnota je "64".

userAgentCacheKeyLength

Volitelný String atributu.

Určuje délku identifikačního řetězce prohlížeče, který chcete použít jako klíč pro objekty schopností mezipaměti prohlížeče v interní mezipaměti. Další informace o objektech schopností prohlížeče naleznete v tématu Schéma definičního souboru prohlížeče (element browsers).

Tento atribut je v rozhraní .NET Framework verze 2.0 nový.

Výchozí hodnota je "64".

Podřízené prvky

Prvek	Popis
filter	Volitelný prvek. Určuje seznam vyhledávacích řetězců, které umožňují aplikovat individuální nastavení pro konkrétní definice prohlížečů.
result	Určuje odvozenou třídu HttpCapabilitiesBase-, která se používá k ukládání výsledků analýzy oddílu browserCaps. Schopnosti jsou uloženy jako dvojice řetězců klíč/hodnota pro každý prohlížeč. Tento element stále platí v rozhraní .NET Framework verze 2.0.
use	Určuje řetězec požadavku protokolu HTTP, který slouží k analýze informací o schopnostech prohlížeče, které jsou uloženy v prvcích filter a case.

filter

Volitelný prvek.

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

result

Určuje odvozenou třídu HttpCapabilitiesBase-, která se používá k ukládání výsledků analýzy oddílu browserCaps. Schopnosti jsou uloženy jako dvojice řetězců klíč/hodnota pro každý prohlížeč.

Tento element stále platí v rozhraní .NET Framework verze 2.0.

use

Určuje řetězec požadavku protokolu HTTP, který slouží k analýze informací o schopnostech prohlížeče, které jsou uloženy v prvcích filter a case.

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

Poznámky

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

Řádky formuláře capsVariableName=regular expression jsou přiřazení. Použijte syntaxi %{capsVariableName} nebo ${captureGroupName} v atributech match a na pravé straně přiřazení.

Další informace o použití regulárních výrazů naleznete v tématu regulární výrazy pro rozhraní .NET framework. Úplný oddíl browserCaps s kompletním příkladem této syntaxe naleznete v souboru Machine.config, který je nainstalován s .NET Frameworkem.

Ke dvojicím název/hodnota, které jsou zachyceny s capsVariableName, lze přistupovat prostřednictvím vlastnosti Item objektu HttpBrowserCapabilities, který dědí z HttpCapabilitiesBase. Vlastnost Item je výchozí vlastnost indexeru v jazyce C#.

Výchozí konfigurace

V rozhraní .NET Framework verze 2.0 je následující výchozí nastavení omezujícího elementu browserCaps konfigurováno v kořenovém souboru Web.config, protože je zastaralý ve prospěch definičních souborů prohlížeče k určení podporovaných prohlížečů a schopností. Další informace naleznete v tématu Schéma definičního souboru prohlížeče (element browsers).

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

V rozhraní .NET Framework verze 1.0 a 1.1 je výchozí element browserCaps, který jsou konfigurován v souboru Machine.config, příliš velký, aby byl zde uveden jeho obsah. 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 objektu HttpBrowserCapabilities.

Soubor určuje páry název/hodnota ve formě přiřazovacího příkazu, který se podobá 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>
 <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>

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.1 nebo 1.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Sdílet prostřednictvím

Element 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