<browserCaps>-Element

2008-03-31

Steuert die Einstellungen der Browserfunktionskomponente. Das <browserCaps>-Element kann für einen einzelnen Computer, den gesamten Standort, eine Anwendung oder ein Unterverzeichnis deklariert werden. Das <browserCaps>-Element kann wie für die Ermittlung künftiger Browser und Browserfunktionen erforderlich aktualisiert werden.

Eine Auflistung gültiger Browsereigenschaften finden Sie in den Erläuterungen zur HttpBrowserCapabilities-Klasse.

<configuration>
<system.web>
** <browserCaps>**

<browserCaps>
   <result type="class"/>   <use var="HTTP_USER_AGENT"/>        browser=Unknown
        version=0.0
        majorver=0
        minorver=0
        frames=false
        tables=false
      <filter>         <case match="Windows 98|Win98">
            platform=Win98
         </case>      <case match="Windows NT|WinNT">
         platform=WinNT
      </case>   </filter>   <filter match="Unknown" with="%(browser)">
      <filter match="Win95" with="%(platform)">
      </filter>   </filter></browserCaps>

Untertags

Untertag	Beschreibung
<use>	Gibt die Servervariablen an, die bei der Evaluierung von <filter>, <case> und Aufgaben im Abschnitt verwendet wurden.
<filter>	Evaluiert das erste übereinstimmende untergeordnete <case>-Element; die restlichen werden ignoriert.
<result>	Gibt die von HttpCapabilitiesBase abgeleitete Klasse an, die die bei der Analyse dieses Abschnitts ermittelten Schlüssel/Wert-Zeichenfolgenpaare enthält (beispielsweise `browser`, `version` und `majorver` im oben stehenden Syntaxblock). Die Zeichenfolge wird zur Laufzeit zur Erstellung des Rückgabetyps verwendet.

Hinweise

Zeilen der Form capsVariableName=regulärer Ausdruck sind Aufgaben. Verwenden Sie in match-Attributen und auf der rechten Seite von Aufgaben die Syntax %{capsVariableName} oder ${captureGroupName}. Weitere Informationen zur Verwendung regulärer Ausdrücke finden Sie unter Reguläre Ausdrücke von .NET Framework. Eine Beschreibung des vollständigen <browserCaps>-Abschnitts und ein ausführlicheres Beispiel für diese Syntax finden Sie in der mit .NET Framework installierten Datei Machine.config.

Auf die mit capsVariableName aufgezeichneten Name-Wert-Paare kann über die Item-Eigenschaft von HttpBrowserCapabilities zugegriffen werden, die von HttpCapabilitiesBase geerbt wird. Die Item-Eigenschaft ist die standardmäßige Indexereigenschaft in C#.

Beispiel

Im folgenden Beispiel wird die Analyse des HTTP-Headers User-Agent für eine beliebige Version von Internet Explorer demonstriert (sofern das Format der User-Agent-Zeichenfolge im Wesentlichen unverändert bleibt).

Im Beispiel werden Reguläre Ausdrücke von .NET Framework verwendet sowie die Fähigkeit regulärer Ausdrücke genutzt, Unterausdrücke zu erfassen, um Versionsnummern direkt von der User-Agent-Zeichenfolge zum <browserCaps>-Objekt zu verschieben.

Die Datei gibt Name/Wert-Paare in Form von Zuweisungsanweisungen an, ähnlich den browscap.ini-Dateien von Microsoft Internet-Informationsdienste (IIS). So wird beispielsweise in der Zeile "browser=IE" als Wert für das Browserfeld die Zeichenfolge "IE" festgelegt.

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

Anforderungen

Enthalten in: <system.web>

Webplattform: IIS 5.0, IIS 5.1, IIS 6.0

Konfigurationsdatei: Machine.config, Web.config

Konfigurationsabschnittshandler: System.Web.Configuration.HttpCapabilitiesSectionHandler

Siehe auch

ASP.NET-Konfiguration | ASP.NET-Einstellungsschema

Freigeben über