Systeminterne XAML-Datentypen

  • Artikel

XAML für die Windows-Runtime stellt auf Sprachebene Unterstützung für mehrere Datentypen bereit, die häufig verwendete Grundtypen in der Common Language Runtime (CLR) und in anderen Programmiersprachen wie C++ sind.

Am häufigsten finden Sie die Verwendung systeminterner XAML-Datentypen, wenn Ressourcen in einem XAML-Ressourcenwörterbuch definiert werden. Sie können in diesem Wörterbuch Konstanten definieren, z. B. Zahlen, die Sie für mehrere Werte verwenden. Sie können auch eine Storyboardanimation verwenden, um eine Animation mithilfe eines Zeichenfolgen- oder booleschen Werts zu erreichen. Sie benötigen dann ein XAML-Objektelement, das die Zeichenfolge oder den booleschen Wert darstellt, um den Keyframe der ObjectAnimationUsingKeyFrames-Definition aufzufüllen. Die Windows-Runtime-XAML-Standardvorlagen verwenden beide Techniken.

XAML für die Windows-Runtime bietet Unterstützung auf Sprachebene für diese Typen:

XAML-Grundtyp BESCHREIBUNG
x:Boolean Für die CLR-Unterstützung: Boolean. XAML analysiert Werte für x:Boolean ohne Berücksichtigung der Groß-/Kleinschreibung. „x:Bool“ ist keine zulässige Alternative.
x:String Für die CLR-Unterstützung: String. Die Codierung für die Zeichenfolge wird standardmäßig auf die umgebende XML-Codierung festgelegt.
x:Double Für die CLR-Unterstützung: Double. Zusätzlich zu den numerischen Werten lässt die Textsyntax für x:Double das Token „NaN“ zu. So kann „Auto“ für das Layoutverhalten als Ressourcenwert gespeichert werden. Bei den Token wird die Groß-/Kleinschreibung berücksichtigt. Sie können die wissenschaftliche Schreibweise verwenden (also beispielsweise „1+E06“ für 1,000,000).
x:Int32 Für die CLR-Unterstützung: Int32. x:Int32 wird als Zahl mit Vorzeichen behandelt. Sie können das Minuszeichen („-“) für eine negative ganze Zahl verwenden. In XAML wird das Fehlen eines Vorzeichens in der Textsyntax als positiver Wert mit Vorzeichen interpretiert.

Diese Grundtypen der Programmiersprache XAML sind im Allgemeinen die einzigen Fälle, in denen Sie ein Objektelement definieren, das das Präfix x: in XAML verwendet. Alle anderen XAML-Sprachfeatures werden in der Regel in Attributform oder als Markuperweiterung verwendet.

Hinweis Gemäß der Konvention werden die Sprachgrundtypen für XAML und alle anderen XAML-Sprachelemente mit dem Präfix "x:" angezeigt. So werden XAML-Sprachelemente in der Regel in realem Markup verwendet. Diese Konvention wird in der Dokumentation für XAML und auch in der XAML-Spezifikation befolgt.

Andere XAML-Grundtypen

In der XAML 2009-Spezifikation werden weitere XAML-Grundtypen auf Sprachebene aufgeführt, etwa x:Uri und x:Single. Falls diese nicht in der Tabelle in diesem Artikel aufgeführt sind, werden andere XAML-Grundtypen auf Sprachebene, die in einem anderen XAML-Vokabular oder in der XAML-Spezifikation von 2009 definiert sind, derzeit von XAML für die Windows-Runtime nicht unterstützt.

Hinweis Datums- und Uhrzeitangaben (Eigenschaften, die DateTime oder DateTimeOffset, TimeSpan oder System.TimeSpan verwenden) sind mit einem XAML-Grundtyp nicht festgelegt. Diese Eigenschaften können in XAML grundsätzlich nicht festgelegt werden, da im XAML-Parser der Windows-Runtime kein Standardverhalten für die Konvertierung der Ausgangszeichenfolge für Datums- und Uhrzeitangaben vorhanden ist. Für Initialisierungswerte von Datums- und Uhrzeiteigenschaften müssen Sie CodeBehind verwenden, der ausgeführt wird, wenn eine Seite oder ein Element geladen wird.