browserCaps elementu (ASP.Schemat ustawień netto)

Artykuł
06/25/2012

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Określa ustawienia obsługiwanych przeglądarek i możliwości obsługiwanych przeglądarek. browserCaps Może być aktualizowany element jako wymagany do określenia nowej przeglądarki i możliwości.

Uwaga

Za pomocą browserCaps elementu w pliku Web.config, aby zdefiniować przeglądarki jest przestarzałe w.NET Framework 2.0, ale nadal jest obsługiwany.Dane w tym elemencie jest scalany z informacji z plików definicji przeglądarki (.browser), znajdujący się w %SystemRoot%\Microsoft.NET\Framework\ poziom maszynywersji\CONFIG\Browsers folder i wszystkie istniejące foldery App_Browser poziomie aplikacji.Aby uzyskać więcej informacji, zobacz Schemat pliku definicji przeglądarki (przeglądarek Element).

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne.

Atrybuty

Atrybut	Opis
userAgentCacheKeyLength	Opcjonalny String atrybut. Określa długość ciąg identyfikacyjny przeglądarki, aby użyć jako klucza do buforowania obiektów możliwości przeglądarki w wewnętrznej pamięci podręcznej. Aby uzyskać więcej informacji na temat obiektów możliwości przeglądarki, zobacz Schemat pliku definicji przeglądarki (przeglądarek Element). Ten atrybut jest nowego w.NET Framework w wersji 2.0. Wartością domyślną jest "64".

userAgentCacheKeyLength

Opcjonalny String atrybut.

Określa długość ciąg identyfikacyjny przeglądarki, aby użyć jako klucza do buforowania obiektów możliwości przeglądarki w wewnętrznej pamięci podręcznej. Aby uzyskać więcej informacji na temat obiektów możliwości przeglądarki, zobacz Schemat pliku definicji przeglądarki (przeglądarek Element).

Ten atrybut jest nowego w.NET Framework w wersji 2.0.

Wartością domyślną jest "64".

Elementy podrzędne

Element	Opis
filter	Opcjonalnego elementu. Określa listę ciągów wyszukiwania, umożliwiające indywidualne ustawienia do definicji konkretnej przeglądarki.
result	Określa HttpCapabilitiesBase-klasy, który jest używany do przechowywania wyników analizy składni browserCaps sekcji. Możliwości są przechowywane jako klucz/wartość pary ciągów dla każdej przeglądarki. Element ten stosuje się nadal w.NET Framework w wersji 2.0.
use	Określa ciąg znaków żądania HTTP, do analizowania informacji o możliwościach przeglądarki, który jest przechowywany w filter i case elementy.

filter

Opcjonalnego elementu.

Określa listę ciągów wyszukiwania, umożliwiające indywidualne ustawienia do definicji konkretnej przeglądarki.

result

Określa HttpCapabilitiesBase-klasy, który jest używany do przechowywania wyników analizy składni browserCaps sekcji. Możliwości są przechowywane jako klucz/wartość pary ciągów dla każdej przeglądarki.

Element ten stosuje się nadal w.NET Framework w wersji 2.0.

use

Określa ciąg znaków żądania HTTP, do analizowania informacji o możliwościach przeglądarki, który jest przechowywany w filter i case elementy.

Elementy nadrzędne

Element	Opis
configuration	Określa element główny wymagane w każdym pliku konfiguracyjnym, który jest używany przez aparatu plików wykonywalnych języka wspólnego oraz.NET Framework aplikacji.
system.web	Określa element główny dla aplikacji ASP.Ustawienia konfiguracji netto w konfiguracji pliku i zawiera elementy konfiguracyjne określające konfigurację programu ASP.NET aplikacje sieci Web i kontrolować zachowanie tych aplikacji.

Uwagi

browserCaps Element określa ustawienia obsługiwanych przeglądarek i możliwości dla obsługiwanych przeglądarek. browserCaps Może być aktualizowany element jako wymagany do określenia nowej przeglądarki i możliwości.

Aby uzyskać listę prawidłowych właściwości przeglądarki, zobacz HttpBrowserCapabilities.

Wiersze w formularzu capsVariableName=wyrażenie regularne są przydziały. Należy użyć składni %{capsVariableName} lub ${captureGroupName} w match atrybuty i po prawej stronie przypisań.

Aby uzyskać więcej informacji na temat używania wyrażeń regularnych, zobacz .NET Framework w wyrażeniach regularnych. Dla pełnego browserCaps sekcji z kompletnym przykładem tej składni, zobacz plik Machine.config, który jest instalowany razem z.NET Framework.

Pary nazwa/wartość, które są przechwytywane z capsVariableName mogą być udostępniane za pośrednictwem Item właściwość HttpBrowserCapabilities obiekt, który jest dziedziczona z HttpCapabilitiesBase klasy. Item Właściwość jest domyślna właściwość indeksująca w języku C#.

Domyślna konfiguracja

W.NET Framework w wersji 2.0, następujące ograniczone domyślne browserCaps element jest skonfigurowany w katalogu głównym pliku Web.config, ponieważ to jest zaniechana przy użyciu plików definicji przeglądarki do określania obsługiwanych przeglądarek i możliwości. Aby uzyskać więcej informacji, zobacz Schemat pliku definicji przeglądarki (przeglądarek Element).

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

W.NET Framework w wersji 1.0, 1.1, domyślnie browserCaps element, który jest skonfigurowany w pliku machine.config jest zbyt duży, aby wyświetlić listę tutaj. Do aktualizacji danych przeglądarki, przejdź do http://www.cyscape.com/browsercaps. Urządzenia okresowe aktualizacje zastępuje ta sekcja możliwości przeglądarki.

Przykład

Poniższy przykład kodu pokazuje jak analizować User-Agent nagłówka HTTP dla dowolnej wersji programu Microsoft Internet Explorer, tak długo, jak format User-Agent ciąg pozostaje w przybliżeniu niezmieniony.

W przykładzie użyto .Wyrażenia regularne ramy NET i możliwość przechwytywania browserCaps w celu przeniesienia numerów wersji bezpośrednio z wyrażeń regularnych User-Agent ciąg HttpBrowserCapabilities obiektu.

Plik Określa pary nazwa/wartość w formie instrukcji przypisania, który jest podobny do plików browscap.ini Microsoft Internet Information Services (IIS). Na przykład linii "browser=IE" ustawia wartość pola przeglądarki na ciąg "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>

Informacje o elementach

Program obsługi sekcji konfiguracji	HttpCapabilitiesSectionHandler
Członkowskie konfiguracji	Browsers
Lokalizacje konfigurowalne	Machine.config Web.config na poziomie katalogu głównego Poziom aplikacji Web.config Directory–level wirtualnego lub fizycznego Web.config
Wymagania	Microsoft Internet Information Services (IIS) w wersji 5.0, 5.1 lub 6.0 .NET Framework w wersji 2.0 (przestarzałe), 1.1 lub 1.0 Microsoft Visual Studio 2003 lub Visual Studio 2005

Zobacz też

Udostępnij za pośrednictwem

browserCaps elementu (ASP.Schemat ustawień netto)

Atrybuty i elementy

Atrybuty

Elementy podrzędne

Elementy nadrzędne

Uwagi

Domyślna konfiguracja

Przykład

Informacje o elementach

Zobacz też

Zadania

Informacje

Koncepcje

Inne zasoby

Dodatkowe zasoby