deviceFilters-Element (ASP.NET-Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Gibt ein Gerät oder eine Geräteklasse im MobileCapabilities-ASP.NET-System basierend auf dem Benutzer-Agent oder Browser an. Mithilfe eines Gerätefilters können Seiten- oder Anwendungsentwickler Steuerelementeigenschaften überschreiben oder Blöcke mit Inhalt sowie Vorlagen definieren, deren Layout und Darstellung geändert werden sollen.
<deviceFilters>
<filter.../>
</deviceFilters>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Keine.
Untergeordnete Elemente
Element |
Beschreibung |
|---|---|
filter |
Optionales Element. Stellt Filterfunktionen für die MobileCapabilities-Klasse bereit. Der Abschnitt <deviceFilters> kann ein oder mehrere Filterelemente enthalten. |
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Das erforderliche Stammelement in jeder von der Common Language Runtime und den .NET Framework-Anwendungen verwendeten Konfigurationsdatei. |
system.web |
Gibt das Stammelement für die ASP.NET-Konfigurationseinstellungen in einer Konfigurationsdatei an. Enthält Elemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern. |
Hinweise
Sie können zwischen den folgenden beiden Typen von Gerätefiltern wählen: Vergleichsauswertungen und Auswertungsdelegaten.
Bei einfachen Vergleichen können Sie einen Vergleichsfilter angeben, indem Sie den Namen einer Funktion und einen Vergleichswert bereitstellen. Wenn der Funktionswert und der bereitgestellte Wert zur Laufzeit übereinstimmen, gibt der Gerätefilter nach der Auswertung true zurück. Boolesche Eigenschaften werden ohne Beachtung der Groß-/Kleinschreibung verglichen. Deshalb sind true und True beide gültig. Beim Vergleichen anderer Eigenschaften wird die Groß- und Kleinschreibung beachtet.
Bei einer komplexeren Auswertung können Sie einen Filter mit einem Auswertungsdelegaten angeben, indem Sie die Klasse und den Methodennamen einer Methode angeben. Die angegebene Methode wird zur Laufzeit aufgerufen, um zu bestimmen, ob der Gerätefilter bei der Auswertung true zurückgibt.
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.
<deviceFilters>
<filter name="IsHtml"
compare="PreferredRendering"
argument="html32" />
<filter name="IsGPSEnabled"
type="MyApplication.MyCapabilityEvaluators,MyApplication"
method="IsGPSEnabled" />
</deviceFilters>
Elementinformationen
Configuration Section Handler |
|
Configuration Member |
|
Configurable Locations |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config |
Requirements |
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
Aufgaben
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Referenz
system.web-Element (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
filter-Element für deviceFilters (ASP.NET-Einstellungsschema)
mobileControls-Element (ASP.NET-Einstellungsschema)
Konzepte
ASP.NET Configuration File Hierarchy
Weitere Ressourcen
Creating ASP.NET Mobile Web Applications
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen