filter-Element für browserCaps (ASP.NET-Einstellungsschema)

Artikel
05/27/2012

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Dieses Element gibt eine Liste von Suchbegriffen an, mit der Sie individuelle Einstellungen auf bestimmte Browserdefinitionen anwenden können.

Hinweis

Das Definieren von Browsern mithilfe des browserCaps-Elements in der Datei Web.config ist in .NET Framework, Version 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).

<filter> 
   [assignments, filter elements and case elements]
<filter>
<filter 
   match="[regular expression]" 
   with="[regular expression]" >
   [browser capability assignments, filter elements, case elements]
</filter>
<filter>
   <case>...</case>
</filter>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
match	Optionales String-Attribut. Gibt einen regulären Ausdruck in .NET Framework an, der auf Übereinstimmung mit dem with-Attribut getestet wird. Wenn dieses Attribut nicht angegeben wird, wird von einer Übereinstimmung ausgegangen.
with	Optionales String-Attribut. Gibt einen zu suchenden regulären Ausdruck oder eine zu suchende Zeichenfolge in .NET Framework an. Wird der Ausdruck oder die Zeichenfolge weggelassen, wird die im use-Element enthaltene Zeichenfolge verwendet.

match

Optionales String-Attribut.

Gibt einen regulären Ausdruck in .NET Framework an, der auf Übereinstimmung mit dem with-Attribut getestet wird. Wenn dieses Attribut nicht angegeben wird, wird von einer Übereinstimmung ausgegangen.

with

Optionales String-Attribut.

Gibt einen zu suchenden regulären Ausdruck oder eine zu suchende Zeichenfolge in .NET Framework an. Wird der Ausdruck oder die Zeichenfolge weggelassen, wird die im use-Element enthaltene Zeichenfolge verwendet.

Untergeordnete Elemente

Element	Beschreibung
case	Ermöglicht das Beenden des Mustervergleichs nach der Verarbeitung der ersten von mehreren Übereinstimmungen.

Ü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.
browserCaps	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.

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.

browserCaps

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.

Hinweise

Das browserCaps-Element gibt eine Liste von Suchbegriffen an, mit der Sie individuelle Einstellungen auf bestimmte Browserdefinitionen anwenden können. Die in der Liste enthaltenen Regeln werden nacheinander angewendet. Das erste untergeordnete case-Element, das übereinstimmt, wird ausgewertet, und die übrigen untergeordneten case-Elemente werden ignoriert.

Standardkonfiguration

In .NET Framework, Version 2.0, wird das filter-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 filter-Standardelemente zu groß, um alle an dieser Stelle aufzulisten. 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 browserCaps-Element zu übernehmen.

Die Datei gibt Name-Wert-Paare in Form von Zuweisungsanweisungen an, die den Dateien browscap.ini von Microsoft Internetinformationsdienste (IIS) ähneln. 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>

Elementinformationen

Konfigurationsabschnittshandler	HttpCapabilitiesSectionHandler
Konfigurationsmember	Browsers
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.0 oder 1.1 Microsoft Visual Studio 2003 oder Visual Studio 2005

Siehe auch

Freigeben über

filter-Element für browserCaps (ASP.NET-Einstellungsschema)

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen