Freigeben über


<DeviceSpecific>-Element

Aktualisiert: November 2007

Das <DeviceSpecific>-Element stellt ein Konstrukt bereit, mit dem eine Auswahl aus mehreren Inhaltsalternativen in Vorlagensätzen und Steuerelementen angegeben werden kann, die gerätespezifische Auswahlmöglichkeiten erfordern. In einem <DeviceSpecific>-Element geben Sie normalerweise ein oder mehrere <Choice>-Elemente mit Attributen an, die angeben, wie die Auswahl in Bezug auf die Funktionen des Zielgeräts ausgewertet wird. Die ausgewählten Elemente werden zur Laufzeit nacheinander ausgewertet, und das erste erfolgreich ausgewertete Element wird verwendet. Jedes <Choice>-Element kann Folgendes enthalten:

  • Eine Filter-Eigenschaft, die den Namen des auszuwertenden Gerätefilters angibt.

  • Zusätzliche Eigenschaften, die die Eigenschaften des übergeordneten Steuerelements überschreiben.

  • Vorlagendefinitionen für das Steuerelement.

Die Auswertung des Choice-Elements ergibt immer true, wenn die Filter-Eigenschaft fehlt. Wenn kein anderes Choice-Element vor dem Auswählen deklariert wurde, wird die Standardauswahl ausgewählt.

Eigenschaften

Eigenschaft

Beschreibung

Choices

Gibt die Auflistung der Auswahlmöglichkeiten in einem <DeviceSpecific>-Element zurück.

HasTemplates

Gibt true zurück, wenn in der aktuellen Auswahl des <DeviceSpecific>/<Choice>-Konstrukts Vorlagen definiert sind.

MobilePage

Gibt die mobile Seite zurück, die dieses <DeviceSpecific>-Element enthält.

Owner

Gibt den Besitzer dieses <DeviceSpecific>-Elements zurück, entweder ein Steuerelement oder ein Format.

SelectedChoice

Gibt die aktuelle Auswahl zurück, oder gibt null zurück, wenn nichts angewendet werden kann.

Kapselungsregeln

Die folgenden Steuerelemente können ein <DeviceSpecific>-Element enthalten.

Steuerelement

Kommentar

MobileControl

Ein MobileControl-Steuerelement oder jedes Steuerelement, das von einem MobileControl-Objekt erbt, kann 0 (null) oder ein <DeviceSpecific>-Element enthalten.

Style

Ein Style-Steuerelement oder jedes Element, das von einem Style-Objekt erbt, kann 0 (null) oder ein <DeviceSpecific>-Element enthalten.

Ein <DeviceSpecific>-Element kann die folgenden Steuerelemente enthalten.

Steuerelement

Kommentar

DeviceSpecificChoice

Ein <DeviceSpecific>-Element kann jede Anzahl von DeviceSpecificChoice-Steuerelementen enthalten.

Beispiel

Beschreibung

Im folgenden Beispiel werden der PrefersGIF-Gerätefilter und der PrefersWBMP-Gerätefilter verwendet, um auf Grundlage der Gerätefunktionen zwischen drei Bild-URLs auszuwählen.

Hinweis:

Die angegebenen Gerätefilter müssen in der Datei Web.config verfügbar sein. Weitere Informationen finden Sie unter Funktionen von mobilen Geräten.

Code

<DeviceSpecific>
  <Choice Filter="PrefersGIF" ImageUrl="colorImg.gif"/>
  <Choice Filter="PrefersWBMP" ImageUrl="myImage.wbmp"/>
  <Choice ImageUrl="monoImg.gif"/>
</DeviceSpecific>

Siehe auch

Konzepte

Referenz zu mobilen Steuerelementen

Referenz

<Choice>-Element (.NET Framework-Entwicklerhandbuch)

Weitere Ressourcen

Elementreferenz