Benutzerdefinierte Attribute für mobile Steuerelemente

Aktualisiert: November 2007

Sie können mit allen ASP.NET Mobile-Steuerelementen benutzerdefinierte Steuerelementattribute mithilfe der IAttributeAccessor-Schnittstelle von ASP.NET-Webseiten festlegen. Diese Schnittstelle stellt die Methoden GetAttribute und SetAttribute bereit. Darüber hinaus macht die MobileControl-Klasse die Auflistung CustomAttributes verfügbar.

Benutzerdefinierte Attribute können zum Angeben zusätzlicher Attribute für ein Steuerelement und in einem gerätespezifischen Adapter zum Anpassen von Verhalten und Wiedergabe des Steuerelements verwendet werden.

Standardmäßig ist das Festlegen benutzerdefinierter Attribute für ein Steuerelement deaktiviert. Es gibt zwei Möglichkeiten zum Aktivieren benutzerdefinierter Attribute:

• Durch Festlegen eines Attributs im <mobileControls>-Abschnitt in der Datei Web.config, wie im folgenden Codebeispiel gezeigt:

  <configuration>
    <system.web>
          ...
        <mobileControls allowCustomAttributes="True" />
        ...
    </system.web>
  </configuration>
  

  Diese Einstellung wirkt sich auf die Standardeinstellung aller Seiten der Anwendung aus.

• Durch das Festlegen der AllowCustomAttributes-Eigenschaft der MobilePage-Klasse auf true. Diese Einstellung wirkt sich auf alle Steuerelemente der Seite aus.

Das wmlFormat-Attribut für das TextBox-Steuerelement wird als Format-Attribut des <input>-WML-Elements an WML-Geräte gesendet. Dies ist ein benutzerdefiniertes Attribut, das sich von den Attributen des Steuerelements aus der Ausgangsklasse unterscheidet. Bevor benutzerdefinierte Attribute verwendet werden können, müssen sie jedoch aktiviert werden. Eine vollständige Auflistung aller gültigen Formate finden Sie in der WML-Spezifikation, die über das Wireless Application Protocol Forum (WAP) unter http://www.wapforum.org verfügbar ist.

Das wmlFormat-Attribut überschreibt die Numeric-Eigenschaft für das TextBox-Steuerelement. Wenn Sie zum Beispiel das wmlFormat-Attribut auf "NNN" festlegen, wird das <input>-Element auf drei numerische Zeichen beschränkt.

Hinweis:

Wenn benutzerdefinierte Attribute aktiviert sind, können Schreibfehler in Eigenschaftennamen fälschlicherweise als benutzerdefinierte Attribute interpretiert werden. Wenn Sie zum Beispiel die Text-Eigenschaft eines Steuerelements irrtümlich als "Txet" angeben, speichert der Parser sie als benutzerdefiniertes Attribut mit der Bezeichnung "Txet", anstatt eine Ausnahme auszulösen. Vorbeugend werden daher benutzerdefinierte Attribute standardmäßig nicht zugelassen.

Siehe auch

Konzepte

Konfigurieren einer Webanwendung für mehrere Geräte

Empfehlungen zum Filtern von Geräten

Geräteauswertungsverfahren

Erweiterte Browserfunktionen

Referenz

HasCapability

MobileControl

Weitere Ressourcen

Erstellen von benutzerdefinierten mobilen Steuerelementen