Schema der Browserdefinitionsdatei (browsers-Element)

Aktualisiert: November 2007

Browserdefinitionsdateien enthalten Definitionen für einzelne Browser. ASP.NET bestimmt zur Laufzeit mithilfe der Informationen im Anforderungsheader, welcher Browsertyp die Anforderung gestellt hat. Dann bestimmt ASP.NET mithilfe von BROWSER-Dateien die Funktionen des Browsers und wie Markup in diesem Browser wiedergegeben wird. Dies unterstützt Webentwickler beim Erstellen von Anwendungen, die auf mobilen Geräten angezeigt werden können. Dabei werden Steuerelementadapter verwendet, die je nach Typ des Geräts das Verhalten eines ASP.NET-Webserver-Steuerelements anpassen. Weitere Informationen finden Sie unter den Verknüpfungen im Abschnitt Siehe auch.

Das browsers-Element verwendet die folgende Struktur.

<browsers>
    <browser id="browser name"
             parentID="parent browser name"
             refID="reference ID">
        <identification>
            <userAgent match="regular expression"
                       nonMatch="regular expression" />
            <header match="regular expression"
                    name="header name"
                    nonMatch="regular expression" />
            <capability match="regular expression"
                        name="capability name"
                        nonMatch="regular expression" />
        </identification>
        <capture>
            <userAgent match="regular expression" />
            <header match="regular expression"
                    name="header name" />
            <capability match="regular expression"
                        name="capability name" />
        </capture>
        <capabilities>
            <capability name="capability name"
                        value="capability value" />
        </capabilities>
        <controlAdapters markupTextWriterType="type name">
            <adapter adapterType="name of adapter class"
                     controlType="name of control class" />
        </controlAdapters>
        <sampleHeaders>
            <header name="header name"
                    value="header value" />
        </sampleHeaders>
    </browser>
    <gateway id="gateway ID"
             parentID="parent browser ID">
        <!-- Same child elements as for <browser>.
        <identification></identification>
        <capture></capture>
        <capabilities></capabilities>
        <controlAdapters></controlAdapters>
        <sampleHeaders></sampleHeaders>
         -->
    </gateway>
    <defaultBrowser id="Default" 
                    parentID="parent browser ID"
                    refID="reference ID" >
        <!-- Same child elements as for <browser>.
        <identification></identification>
        <capture></capture>
        <capabilities></capabilities>
        <controlAdapters></controlAdapters>
        <sampleHeaders></sampleHeaders>
         -->
    </defaultBrowser>
</browsers>

Attribute und Elemente

    <controlAdapters markupTextWriterType="System.Web.UI.XhtmlTextWriter" >
        <adapter
          controlType="System.Web.UI.WebControls.Menu"
          adapterType="System.Web.UI.WebControls.Adapters.MenuAdapter">
        </adapter>
    </controlAdapters>

<browser refID="IE">
    <capabilities>
        <capability name="UseRichTextBox" value="true" />
    </capabilities>
    <controlAdapters>
        <adapter controlType="System.Web.UI.Calendar"
adapterType="ExampleAdapters.ExampleIECalendarAdapter"
        />
    </controlAdapters>
</browser>

    <capabilities>
        <capability name="browser"          value="IE" />
        <capability name="extra"            value="${extra}" />
        <capability name="isColor"          value="true" />
        <capability name="letters"          value="${letters}" />
        <capability name="majorversion"     value="${major}" />
        <capability name="minorversion"     value="${minor}" />
        <capability name="screenBitDepth"   value="8" />
        <capability name="type"             value="IE${major}" />
        <capability name="version"          value="${version}" />
    </capabilities>

    <browser id="IE5to9" parentID="IE">
        <identification>
            <capability name="majorversion" match="^[5-9]" />
        </identification>
        <!-- Capability elements. -->
    </browser>

    <capture>
        <userAgent match="PalmSource; Blazer 3\.0\)\s\d+;(?'screenPixelsHeight'\d+)x(?'screenPixelsWidth'\d+)$" />
    </capture>

    <capture>
        <header name="HTTP_X_UP_DEVCAP_NUMSOFTKEYS" 
                match="(?'softkeys'\d+)" />
    </capture>

    <defaultBrowser id="Default">
        <capabilities>
            <capability name="ecmascriptversion"   value="0.0" />
            <capability name="javascript"          value="false" />
            <capability name="jscriptversion"      value="0.0" />
        </capabilities>
    </defaultBrowser>

    <gateway id="IE3AK" parentID="IE3">
        <identification>
            <capability name="extra" match="; AK;" />
        </identification>
        <capture>
        </capture>
        <capabilities>
            <capability name="ak"  value="true" />
        </capabilities>
    </gateway>

<identification>
    <header name="Accept" 
            match="text/vnd\.wap\.wml|text/hdml" />
    <header name="Accept" 
            nonMatch="application/xhtml\+xml; profile|application/vnd\.wap\.xhtml\+xml" />
</identification>

        <identification>
            <userAgent match="MSIE 4" />
        </identification>

Hinweise

Wenn Sie feststellen, dass keine der vorhandenen Browserdefinitionsdateien die Kriterien erfüllt, können Sie neue Browserdefinitionsdateien mithilfe des Codes im untenstehenden Abschnitt Beispiel erstellen.

Sicherheitshinweis:
Sie sollten Browserdefinitionsdateien von Drittanbietern nur herunterladen oder installieren, wenn Sie diese als vertrauenswürdig einstufen. Überprüfen Sie eine neue Browserdefinitionsdatei auf Verweise auf unbekannte Namespaces. Weitere Informationen finden Sie unter Absichern von Browserdefinitionsdateien.

Vordefinierte Browserdefinitionsdateien werden im Verzeichnis %SystemRoot%\Microsoft.NET\Framework\Version\CONFIG\Browsers gespeichert. Browserdefinitionsdateien der Anwendungsebene können im Verzeichnis App_Browsers der Anwendung gespeichert werden. An beiden Speicherorten müssen Browserdefinitionsdateien die Dateinamenerweiterung .browser aufweisen. Die in ASP.NET enthaltenen Browserdefinitionsdateien sollten nicht geändert werden, da diese Dateien möglicherweise durch Service Packs aktualisiert werden und dabei Ihre Änderungen überschrieben werden. Erstellen Sie stattdessen neue BROWSER-Dateien und verwenden Sie das parentID-Attribut in einer neuen browser-Definition zum Erben von Einstellungen, oder fügen Sie einer vorhandenen Browserdefinition mithilfe des refID-Attributs Funktionen hinzu.

Informationen zu Browserdefinitionsdateien werden zur Laufzeit in einer Auflistung von bekannten Browsern in einem BrowserCapabilitiesFactory-Objekt zusammengeführt. Wenn eine Anforderung gestellt wird, identifiziert ASP.NET anhand des Anforderungsheader den anfordernden Browser und kompiliert ein HttpBrowserCapabilities-Objekt, das dem Typ des angeforderten Browsers entspricht. Bei diesem Vorgang wird mit einem leeren Verzeichnis begonnen, und auf die Browserdefinitionsstruktur werden die folgenden rekursiven Schritte angewendet:

1. Beginnen mit der Standardbrowserdefinition, die immer als Übereinstimmung gilt.

2. Zusammenführen der in dieser Browserdefinition angegebenen Funktionswerte mit dem Funktionswörterbuch für diesen Browser. In einer Browserdefinition angegebene Werte überschreiben die in einem übergeordneten Element angegebenen Werte.

3. Werten Sie alle untergeordneten Definitionen aus, um eine Übereinstimmung zu ermitteln. Beginnen Sie für jedes übereinstimmende untergeordnete Element wieder bei Schritt 1. Browserdefinitionen werden nach Gatewaydefinitionen ausgewertet. Wenn der Benutzer-Agent mit mehr als einer Browserdefinition oder mehr als einer Gatewaydefinition übereinstimmt, wird zur Laufzeit eine Ausnahme ausgelöst.

Das HttpBrowserCapabilities-Objekt wird zwischengespeichert und kann für eine andere Anforderung eines Browsers vom gleichen Typ wiederverwendet werden.

Eine Webanwendung kann auf die aktuelle Instanz des HttpBrowserCapabilities-Objekts mithilfe der HttpRequest.Browser-Eigenschaft zugreifen. Dieses Objekt ist schreibgeschützt und enthält Eigenschaften für jede Funktion. Webentwickler können auch eine benutzerdefinierte Klasse erstellen, die von der HttpBrowserCapabilities-Klasse erbt, und eine Instanz in der HttpRequest.Browser-Eigenschaft speichern.

Änderungen an BROWSER-Dateien im Verzeichnis App_Browsers machen den Zwischenspeicher ungültig, und die nächste Anforderung bewirkt, dass die Anwendung erneut kompiliert wird. Wenn jedoch BROWSER-Dateien im Verzeichnis %SystemRoot%\Microsoft.NET\Framework\Version\CONFIG\Browsers geändert werden, müssen Sie die Anwendung mit dem Tool %SystemRoot%\Microsoft.NET\Framework\Version\aspnet_regbrowsers.exe erneut kompilieren. Die Anwendung kann auch mithilfe der BrowserCapabilitiesCodeGenerator-Klasse programmgesteuert erneut kompiliert werden.

Wenn ein Browser eine Anforderung an Ihre Anwendung stellt, werden die Funktionen des Browsers in der Browser-Eigenschaft gespeichert. Die Identität des Browsers wird in der UserAgent-Eigenschaft gespeichert. ASP.NET-Webserver-Steuerelemente fragen die Liste von Funktionen ab, um zu entscheiden, wie das Verhalten von Steuerelementen auf geeignete Weise an verschiedene Browser angepasst werden soll.

Funktionen

Eine Liste von stark typisierten Browserfunktionen finden Sie unter den Eigenschaften der HttpCapabilitiesBase-Klasse. Diese Eigenschaften verwenden die Höckerschreibweise in Browserdefinitionsdateien. Wenn Sie beispielsweise die BackgroundSounds-Funktion in Ihrer Browserdefinitionsdatei angeben möchten, geben Sie backgroundSounds ein.

Sie können auch eigene Funktionen definieren.

Es gibt zwei Möglichkeiten, wie eine Webanwendung Funktionswerte vom HttpBrowserCapabilities-Objekt abrufen kann:

• Durch Zugriff auf das Funktionswörterbuch. Diese Methode kann für benutzerdefinierte Funktionen verwendet werden.

  Sie können beispielsweise den Wert der ECMAScript-Funktion (JavaScript) für den Browser des aktuellen Clients mithilfe des folgenden Codes abrufen:

  String cap_javascript = Request.Browser["javascript"];
  

• Durch Aufrufen einer stark typisierten Eigenschaft, die eine Funktion einbindet.

  Sie können beispielsweise den Wert der ECMAScript-Funktion für den Browser des aktuellen Clients mithilfe des folgenden Codes abrufen:

  String cap_javascript = Request.JavaScript;
  

Standardkonfiguration

.NET Framework verfügt über vordefinierte Browserdefinitionsdateien im Verzeichnis %SystemRoot%\Microsoft.NET\Framework\Version\CONFIG\Browsers. Sie können Browserdefinitionsdateien auf Anwendungsebene im Verzeichnis App_Browsers der Anwendung erstellen. Informationen zu besonderen ASP.NET-Verzeichnissen finden Sie unter ASP.NET-Websitelayout.

Das folgende Codebeispiel ist ein Auszug aus der Datei Generic.browser im Verzeichnis %SystemRoot%\Microsoft.NET\Framework\Version\CONFIG\Browsers.

<browsers>
    <browser id="GenericDownlevel" parentID="Default">
        <identification>
            <userAgent match="^Generic Downlevel$" />
        </identification>

        <capture>
        </capture>

        <capabilities>
            <capability name="cookies"                     value="false" />
            <capability name="ecmascriptversion"           value="1.0" />
            <capability name="tables"                      value="true" />
            <capability name="type"                        value="Downlevel" />
        </capabilities>
        <controlAdapters>
            <adapter controlType="System.Web.UI.WebControls.Menu"
            adapterType="System.Web.UI.WebControls.Adapters.MenuAdapter" />
        </controlAdapters>
    </browser>
</browsers>

Das folgende Codebeispiel ist ein Auszug aus der Datei WebTV.browser im Verzeichnis %SystemRoot%\Microsoft.NET\Framework\Version\CONFIG\Browsers.

<browsers>
    <browser id="WebTV" parentID="IE2">
        <identification>
            <userAgent match="WebTV/(?'version'(?'major'\d+)(?'minor'\.\d+)(?'letters'\w*))" />
        </identification>

        <capture>
        </capture>

        <capabilities>
            <capability name="backgroundsounds"    value="true" />
            <capability name="browser"             value="WebTV" />
            <capability name="cookies"             value="true" />
            <capability name="isMobileDevice"      value="true" />
            <capability name="letters"             value="${letters}" />
            <capability name="majorversion"        value="${major}" />
            <capability name="minorversion"        value="${minor}" />
            <capability name="tables"              value="true" />
            <capability name="type"                value="WebTV${major}" />
            <capability name="version"             value="${version}" />
        </capabilities>

        <controlAdapters markupTextWriterType="System.Web.UI.Html32TextWriter">
        </controlAdapters>
    </browser>

    <browser id="WebTV2" parentID="WebTV">
        <identification>
            <capability name="minorversion" match="2" />
        </identification>

        <capture>
        </capture>

        <capabilities>
            <capability name="css1"                value="true" />
            <capability name="ecmascriptversion"   value="1.0" />
            <capability name="javascript"          value="true" />
        </capabilities>
    </browser>

    <gateway id="WebTVbeta" parentID="WebTV">
        <identification>
            <capability name="letters" match="^b" />
        </identification>

        <capture>
        </capture>

        <capabilities>
            <capability name="beta"    value="true" />
        </capabilities>
    </gateway>
</browsers>

Beispiel

Das folgende Codebeispiel ist eine leere BROWSER-Datei, in der Sie Elemente erstellen können. Stellen Sie sicher, dass keine zirkulären Verweise in den Browserdateien erstellt werden.

<?xml version="1.0" encoding="utf-8"?>

<browsers>
    <browser id="NewBrowser" parentID="Mozilla">
        <identification>
            <userAgent match="Unique User Agent Regular Expression" />
        </identification>

        <capture>
            <userAgent match="NewBrowser (?'version'\d+\.\d+)" />
        </capture>

        <capabilities>
            <capability name="browser" value="My New Browser" />
            <capability name="version" value="${version}" />
        </capabilities>
    </browser>

    <browser refID="Mozilla">
        <capabilities>
            <capability name="xml" value="true" />
        </capabilities>
    </browser>
</browsers>

Elementinformationen

Siehe auch

Aufgaben

Gewusst wie: Erkennen von Browsertypen auf ASP.NET-Webseiten

Konzepte

ASP.NET-Webserversteuerelemente und Browserfunktionen

Absichern von Browserdefinitionsdateien

ASP.NET-Konfigurationsszenarios

Übersicht über die Gerätefilterung in ASP.NET

Architektonische Übersicht über das adaptive Steuerelementverhalten

Übersicht über die ASP.NET-Webentwicklung für mobile Geräte

Referenz

Browsers

Capabilities

HttpCapabilitiesSectionHandler

HttpBrowserCapabilities

deviceFilters-Element (ASP.NET-Einstellungsschema)

mobileControls-Element (ASP.NET-Einstellungsschema)

browserCaps-Element (ASP.NET-Einstellungsschema)

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen