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