browserCaps-Element (ASP.NET-Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Gibt die Einstellungen unterstützter Browser und deren Funktionen an. Das browserCaps-Element kann nach Bedarf zum Angeben neuer Browser und deren Funktionen aktualisiert werden.
Hinweis
Das Definieren von Browsern mithilfe des browserCaps-Elements in der Datei Web.config ist in .NET Framework 2.0 veraltet, wird jedoch weiterhin unterstützt.Die Daten in diesem Element werden mit den Daten aus den Browserdefinitionsdateien (.browser) zusammengeführt, die auf Computerebene im Ordner %SystemRoot%\Microsoft.NET\Framework\Version\CONFIG\Browsers und auf Anwendungsebene ggf. im Ordner App_Browser gespeichert sind.Weitere Informationen finden Sie unter Schema der Browserdefinitionsdatei (browsers-Element).
<browserCaps>
<result />
<use />
[browser capability property assignments]
<filter>...</filter>
</browserCaps>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
userAgentCacheKeyLength |
Optionales String-Attribut. Gibt die Länge der kennzeichnenden Zeichenfolge des Browsers an, die als Schlüssel zum Zwischenspeichern von Browserfunktionsobjekten im internen Cache verwendet wird. Weitere Informationen über Browserfunktionsobjekte finden Sie unter Schema der Browserdefinitionsdatei (browsers-Element). Dieses Attribut ist neu in .NET Framework, Version 2.0. Der Standardwert ist "64". |
Untergeordnete Elemente
Element |
Beschreibung |
|---|---|
filter |
Optionales Element. Gibt eine Liste von Suchbegriffen an, mit der Sie individuelle Einstellungen auf bestimmte Browserdefinitionen anwenden können. |
result |
Gibt die von HttpCapabilitiesBase abgeleitete Klasse an, die die Ergebnisse der Analyse des browserCaps-Abschnitts enthält. Die Funktionen werden als Schlüssel/Wert-Zeichenfolgenpaare für jeden Browser gespeichert. Dieses Element gilt weiterhin in .NET Framework, Version 2.0. |
use |
Gibt die HTTP-Anforderungszeichenfolge an, die zum Analysieren der im filter-Element und im case-Element gespeicherten Browserfunktionsinformationen verwendet wird. |
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird. |
system.web |
Gibt das Stammelement für die ASP.NET-Konfigurationseinstellungen in einer Konfigurationsdatei an und enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern. |
Hinweise
Das browserCaps-Element gibt die Einstellungen unterstützter Browser und deren Funktionen an. Das browserCaps-Element kann nach Bedarf zum Angeben neuer Browser und deren Funktionen aktualisiert werden.
Eine Auflistung gültiger Browsereigenschaften finden Sie unter HttpBrowserCapabilities.
Zeilen in der Form capsVariableName=regulärer Ausdruck sind Zuweisungen. Verwenden Sie in match-Attributen und auf der rechten Seite von Zuweisungen die Syntax %{capsVariableName} oder ${captureGroupName}.
Weitere Informationen zum Verwenden von regulären Ausdrücken finden Sie unter Reguläre Ausdrücke von .NET Framework. Eine Beschreibung des vollständigen browserCaps-Abschnitts und ein ausführliches Beispiel für diese Syntax finden Sie in der Datei Machine.config, die zusammen mit .NET Framework installiert wurde.
Der Zugriff auf die mit capsVariableName erfassten Name-Wert-Paare erfolgt über die Item-Eigenschaft des HttpBrowserCapabilities-Objekts, die von der HttpCapabilitiesBase-Klasse geerbt wurde. Die Item-Eigenschaft ist die standardmäßige Indexereigenschaft in C#.
Standardkonfiguration
In .NET Framework, Version 2.0, wird das folgende eingeschränkte browserCaps-Standardelement in der Stammkonfigurationsdatei Web.config konfiguriert, da dieses Element veraltet ist und stattdessen nun Browserdefinitionsdateien zum Festlegen unterstützter Browser und deren Funktionen verwendet werden. Weitere Informationen finden Sie unter Schema der Browserdefinitionsdatei (browsers-Element).
<browserCaps userAgentCacheKeyLength="64">
<result
type="System.Web.Mobile.MobileCapabilities, System.Web.Mobile, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
/>
</browserCaps>
In .NET Framework, Version 1.0 und 1.1, ist das in der Datei Machine.config konfigurierte browserCaps-Standardelement zu groß, um es an dieser Stelle vollständig auflisten zu können. Aktualisierungen der Browserdaten können Sie unter http://www.cyscape.com/browsercaps durchführen. Regelmäßige Geräteupdates ersetzen diesen Abschnitt über Browserfunktionen.
Beispiel
Der folgende Beispielcode demonstriert die Analyse eines User-Agent-HTTP-Headers für alle Versionen von Microsoft Internet Explorer (sofern das Format der User-Agent-Zeichenfolge nicht grundlegend geändert wird).
Im Beispiel werden Reguläre Ausdrücke in .NET Framework sowie die Fähigkeit regulärer Ausdrücke zum Erfassen von Teilausdrücken verwendet, um die Versionsnummern direkt aus der User-Agent-Zeichenfolge in das HttpBrowserCapabilities-Objekt zu übernehmen.
Die Datei gibt Name-Wert-Paare in Form von Zuweisungsanweisungen an, ähnlich den Dateien browscap.ini von Microsoft Internetinformationsdienste (IIS). So wird beispielsweise in der Zeile "browser=IE" als Wert für das Browserfeld die Zeichenfolge "IE" festgelegt.
<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>
Elementinformationen
Konfigurationsabschnittshandler |
|
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physischer Verzeichnisse |
Anforderungen |
Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 2.0 (veraltet), 1.1 oder 1.0 Microsoft Visual Studio 2003 oder Visual Studio 2005 |
Siehe auch
Aufgaben
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
Referenz
system.web-Element (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
filter-Element für browserCaps (ASP.NET-Einstellungsschema)
result-Element für browserCaps (ASP.NET-Einstellungsschema)
use-Element für browserCaps (ASP.NET-Einstellungsschema)
Schema der Browserdefinitionsdatei (browsers-Element)
HttpCapabilitiesSectionHandler
Konzepte
ASP.NET Server Controls and Browser Capabilities
ASP.NET Configuration File Hierarchy
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen