use-Element für browserCaps (ASP.NET-Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Bestimmt die HTTP-Anforderungszeichenfolge, die zum Analysieren der im filter-Element und im case-Element gespeicherten Browsereigenschaften verwendet wird.
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).
<use
var="server variable"
as="variableName"
/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
var |
Optionales String-Attribut. Gibt die IIS-Servervariable (Microsoft Internetinformationsdienste) an, die zum Extrahieren der Browsereigenschaften analysiert wird. Der Standardwert ist "HTTP_USER_AGENT". |
as |
Optionales String-Attribut. Gibt einen Namen an, der verwendet werden kann, um in nachfolgenden regulären Ausdrücken auf die Servervariable zu verweisen. |
Untergeordnete Elemente
Keine.
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Das erforderliche Stammelement in jeder Konfigurationsdatei, 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. |
browserCaps |
Gibt die Einstellungen unterstützter Browser und deren Funktionen an. Das Element kann nach Bedarf zum Angeben neuer Browser und ihrer Fähigkeiten aktualisiert werden. Eine Auflistung gültiger Browsereigenschaften finden Sie unter HttpBrowserCapabilities. |
Hinweise
Das use-Element gibt die HTTP-Anforderungszeichenfolge an, die zum Analysieren der im filter-Element und im case-Element gespeicherten Browsereigenschaften verwendet wird.
Standardkonfiguration
In .NET Framework, Version 2.0, wird das use-Element nicht konfiguriert, da das browserCaps-Element nicht mehr verwendet wird. Stattdessen werden nun Browserdefinitionsdateien zum Festlegen der unterstützten Browser und ihrer Fähigkeiten verwendet. Weitere Informationen finden Sie unter Schema der Browserdefinitionsdatei (browsers-Element).
In .NET Framework, Version 1.0 und 1.1, ist die Anzahl der in der Datei Machine.config konfigurierten use-Standardelemente zu groß, um sie an dieser Stelle aufzulisten. Updates der Browserdaten können Sie bei cyScape, Inc. unter http://www.cyscape.com/browsercaps durchführen. Regelmäßige Geräteupdates ersetzen diesen Abschnitt über Browserfunktionen.
Beispiel
Das folgende Codebeispiel veranschaulicht, wie festgelegt wird, dass die IIS-Servervariable HTTP_USER_AGENT die Quelle für die Browsereigenschaften ist.
<use var="HTTP_USER_AGENT">
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
browserCaps-Element (ASP.NET-Einstellungsschema)
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)
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