Udostępnij za pośrednictwem


Filtrowanie elementów browserCaps (ASP.Schemat ustawień netto)

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

Ten element określa listę wyszukiwanych ciągów, które pozwalają na zastosowanie indywidualnych ustawień do definicji konkretnej przeglądarki.

Uwaga

Za pomocą browserCaps elementu w pliku Web.config, aby zdefiniować przeglądarki jest przestarzałe w.NET Framework w wersji 2.0; jednak nadal jest obsługiwany.Dane w tym elemencie jest scalany z informacji z plików definicji przeglądarki (.browser), które znajdują się w %SystemRoot%\Microsoft.NET\Framework\ poziom maszynywersji\CONFIG\Browsers folder i wszystkie istniejące foldery App_Browsers poziomie aplikacji.Aby uzyskać więcej informacji, zobacz Schemat pliku definicji przeglądarki (przeglądarek 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>

Atrybuty i elementy

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

Atrybuty

Atrybut

Opis

match

Opcjonalny String atrybut.

Określa.NET Framework wyrażenie regularne, które jest testowana with atrybut. Jeśli pominięto, zakłada pomyślne dopasowanie.

with

Opcjonalny String atrybut.

Określa.Wyrażenie regularne NET Framework lub ciąg do wyszukania. Jeśli pominięto, ciąg znaków, który jest określony przez use element jest używany.

Elementy podrzędne

Element

Opis

case

Umożliwia zatrzymanie po przetworzeniu pierwszego pomyślnego dopasowania z liczby alternatyw dopasowywania do wzorca.

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.

browserCaps

Określa ustawienia obsługiwanych przeglądarek i możliwości przeglądarki. 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.

Uwagi

browserCaps Element określa listę wyszukiwanych ciągów, które pozwalają na zastosowanie indywidualnych ustawień do definicji konkretnej przeglądarki. Reguły, które są zawarte w wykazie są stosowane w sekwencji. Pierwsze dziecko case element pasuje do szacowania i pozostałe podrzędne case elementy są ignorowane.

Domyślna konfiguracja

W.NET Framework w wersji 2.0, filter element nie jest skonfigurowane, ponieważ browserCaps element zostanie zaniechana przy użyciu plików definicji przeglądarki do określania obsługiwanych przeglądarek i możliwości przeglądarki. Aby uzyskać więcej informacji, zobacz Schemat pliku definicji przeglądarki (przeglądarek Element).

W.NET Framework w wersji 1.0, 1.1, domyślnie filter elementów, które są skonfigurowane w pliku Machine.config jest zbyt duża, 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.

Przykład korzysta z .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 browserCaps element.

Plik Określa pary nazwa/wartość w formie instrukcji przypisania, które są podobne 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>
   <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>

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.0 i 1.1

Microsoft Visual Studio 2003 lub Visual Studio 2005

Zobacz też

Zadania

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

Informacje

browserCaps elementu (ASP.Schemat ustawień netto)

sprawa elementu filtru dla browserCaps (ASP.Schemat ustawień netto)

System.Web elementu (ASP.Schemat ustawień netto)

Konfiguracja elementu (schemat ustawień ogólne)

wynik Element browserCaps (ASP.Schemat ustawień netto)

Użyj elementu dla browserCaps (ASP.Schemat ustawień netto)

Schemat pliku definicji przeglądarki (przeglądarek Element)

System.Configuration

System.Web.Configuration

HttpCapabilitiesSectionHandler

Browsers

Koncepcje

ASP.NET Server Controls and Browser Capabilities

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Inne zasoby

Ogólne ustawienia konfiguracji (ASP.(NET)

ASP.NET ustawienia konfiguracji

Configuring ASP.NET Applications

ASP.NET Configuration API