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

Artikel
09/03/2008

Aktualisiert: November 2007

Stellt Filterfunktionen für die MobileCapabilities-Klasse bereit.

configuration-Element (allgemeines Einstellungsschema)
  system.web-Element (ASP.NET-Einstellungsschema)
    deviceFilters-Element (ASP.NET-Einstellungsschema)
      filter-Element für deviceFilters (ASP.NET-Einstellungsschema)

<filter name="capability"
        compare="capabilityName"
        argument="argument" />
<filter name="capability"
        type="className"
        method="methodName" />

Attribute und Elemente

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

Attribute

Attribute	Beschreibung
argument	Optionales String-Attribut. Gibt das Argument an, mit dem die Funktion verglichen werden soll. Wenn das compare-Attribut definiert ist, ist dieses Attribut erforderlich.
compare	Optionales String-Attribut. Gibt die von der Vergleichsauswertung bewertete Browserfunktion an. Es kann sich um eine integrierte Funktion oder um den Namen einer benutzerdefinierten Funktionsauswertung angegeben. Wenn Sie einen Vergleichsfilter angeben, ist dieses Attribut erforderlich.
method	Optionales String-Attribut. Gibt die Methode an, die den Auswertungsdelegaten bereitstellt. Wird beim Angeben eines Auswertungsdelegatfilters verwendet. Wenn das type-Attribut angegeben ist, ist dieses Attribut erforderlich, und das compare-Attribut und das argument-Attribut können nicht angegeben werden.
name	Erforderliches String-Attribut. Gibt den eindeutigen Namen an, mit dem der Filter bestimmt werden soll. Tipp Ein Filter mit demselben Namen wie ein zuvor definierter Filter (der an späterer Stelle in der Konfigurationsdatei oder in der Hierarchie der Konfigurationsdatei steht) überschreibt den zuvor definierten Filter.
type	Optionales String-Attribut. Gibt den Klassentyp an, der den Auswertungsdelegaten bereitstellt.

Untergeordnete Elemente

Keines.

Übergeordnete Elemente

Element	Beschreibung
configuration	Das erforderliche Stammelement 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. Enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern.
deviceFilters	Gibt ein Gerät oder eine Geräteklasse im MobileCapabilities-ASP.NET-System basierend auf dem Benutzeragent oder Browser an.

Hinweise

Beim Erstellen einer Webanwendung mit gerätespezifischem Inhalt müssen Sie einen oder mehrere Filter in einem deviceFilters-Abschnitt in der Konfigurationsdatei hinzufügen. Jeder Filter gibt einige Kriterien an, die auf Zielgeräte abgestimmt werden sollten.

Durch die Konfiguration der Gerätefilter wird ein Auswertungsmechanismus für zwei Arten von Filtern bereitgestellt: für einen Vergleichsfilter und für einen Filter für Auswertungsdelegaten. Die Syntax gibt beide Filtertypen an. Der erste Filter zeigt den auf Vergleich basierenden Filter an und der zweite den Filter für Auswertungsdelegaten. Ausführliche Informationen zum Erstellen von Filtern in der Konfigurationsdatei finden Sie unter Gerätespezifische Wiedergabe.

Bei den Gerätefiltern muss die Groß- und Kleinschreibung beachtet werden. Der Filter "isColor" und der Filter "IsColor" werden als unterschiedliche Filter betrachtet.

Standardkonfiguration

Das folgende deviceFilters-Standardelement wird nicht explizit in der Computerkonfigurationsdatei oder Web.config-Stammdatei konfiguriert, sondern stellt die von einer Anwendung in .NET Framework, Version 2.0, zurückgegebene Standardkonfiguration dar.

<deviceFilters>
    <filter name="isJPhone" compare="Type" argument="J-Phone"/>
    <filter name="isHTML32" compare="PreferredRenderingType" argument="html32"/>
    <filter name="isWML11" compare="PreferredRenderingType" argument="wml11"/>
    <filter name="isCHTML10" compare="PreferredRenderingType" argument="chtml10"/>
    <filter name="isGoAmerica" compare="Browser" argument="Go.Web"/>
    <filter name="isMME" compare="Browser" argument="Microsoft Mobile Explorer"/>
    <filter name="isMyPalm" compare="Browser" argument="MyPalm"/>
    <filter name="isPocketIE" compare="Browser" argument="Pocket IE"/>
    <filter name="isUP3x" compare="Type" argument="Phone.com 3.x Browser"/>
    <filter name="isUP4x" compare="Type" argument="Phone.com 4.x Browser"/>
    <filter name="isEricssonR380" compare="Type" argument="Ericsson R380"/>
    <filter name="isNokia7110" compare="Type" argument="Nokia 7110"/>
    <filter name="prefersGIF" compare="PreferredImageMIME" argument="image/gif"/>
    <filter name="prefersWBMP" compare="PreferredImageMIME" argument="image/vnd.wap.wbmp"/>
    <filter name="supportsColor" compare="IsColor" argument="true"/>
    <filter name="supportsCookies" compare="Cookies" argument="true"/>
    <filter name="supportsJavaScript" compare="Javascript" argument="true"/>
    <filter name="supportsVoiceCalls" compare="CanInitiateVoiceCall" argument="true"/>
</deviceFilters>

Beispiel

Im folgenden Beispiel werden sowohl ein Vergleichsfilter als auch ein Auswertungsdelegatfilter konfiguriert. Der erste Filter zeigt einen vergleichsbasierten Filter an und der zweite einen Filter für Auswertungsdelegaten.

<deviceFilters>
  <filter name="IsHtml" 
    compare="PreferredRendering" 
    argument="html32" />
  <filter name="IsGPSEnabled" 
    type="Application1.CapabilityEvaluators1,Application1" 
    method="IsGPSEnabled" />
</deviceFilters>

Elementinformationen

Konfigurationsabschnittshandler	System.Web.Mobile.DeviceFiltersSection
Konfigurationsmember	SystemWebSectionGroup.DeviceFilters DeviceSpecificChoice.Filter
Konfigurierbare Verzeichnisse	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physikalischer Verzeichnisse
Voraussetzungen	IIS 5.0, IIS 5.1 oder IIS 6.0 .NET Framework 1.1 oder 2.0 Visual Studio 2003 oder Visual Studio 2005

Siehe auch

Freigeben über

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

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Konzepte

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen