use-Element für browserCaps (ASP.NET-Einstellungsschema)
Bestimmt die HTTP-Anforderungszeichenfolge, die zum Analysieren der im filter-Element und im case-Element gespeicherten Browsereigenschaften verwendet wird.
.gif "Hinweis") 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, untergeordnete Elemente 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 der unterstützten Browser und die Fähigkeiten der Browser 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 physikalischer 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
Gewusst wie: Erkennen von Browsertypen und Browserfunktionen auf ASP.NET-Webseiten
Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen
Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen
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-Webserversteuerelemente und Browserfunktionen
ASP.NET-Konfigurationsdateihierarchie und Vererbung
Absichern der ASP.NET-Konfiguration
ASP.NET-Konfigurationsszenarios
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)