Freigeben über


Systeminterne XAML-Datentypen

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

Am häufigsten sehen Sie die verwendung systeminterner XAML-Datentypen, wenn Ressourcen in einem XAML-Ressourcenwörterbuch definiert sind. Sie können dort Konstanten definieren, z. B. Zahlen, die Sie für mehrere Werte verwenden. Oder Sie können eine Storyboardanimation verwenden, die mit einer Zeichenfolge oder einem booleschen Wert animiert wird, und Sie benötigen dann ein XAML-Objektelement, das die Zeichenfolge oder den Booleschen Wert darstellt, um den Keyframe Ihrer ObjectAnimationUsingKeyFrames-Definition auszufüllen. Die Windows-Runtime Standard-XAML-Vorlagen 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 CLR-Unterstützung entspricht boolescher Wert. XAML analysiert Werte für x:Boolean , wenn die Groß-/Kleinschreibung nicht beachtet wird. Beachten Sie, dass "x:Bool" keine akzeptierte Alternative ist.
x:String Entspricht der CLR-Unterstützung Zeichenfolge. Die Codierung für die Zeichenfolge entspricht standardmäßig der umgebenden XML-Codierung.
x:Double Für CLR-Unterstützung entspricht Double. Neben den numerischen Werten lässt die Textsyntax für x:Double das Token "NaN" zu, was bedeutet, dass "Auto" für das Layoutverhalten als Ressourcenwert gespeichert werden kann. Die Token werden als Groß-/Kleinschreibung behandelt. Sie können wissenschaftliche Schreibweise verwenden, z. B. "1+E06" für 1,000,000.
x:Int32 Für CLR-Unterstützung entspricht Int32. x:Int32 wird als signiert behandelt, und Sie können das Minuszeichen ("-") für eine negative ganze Zahl einschließen. In XAML bedeutet das Fehlen einer Zeichentextsyntax einen positiven signierten Wert.

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

Hinweis Nach 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

Die XAML 2009-Spezifikation enthält weitere XAML-Grundtypen auf Sprachebene, z . B. x:Uri und x:Single. Sofern in der Tabelle in diesem Thema nicht aufgeführt, werden andere XAML-Sprachgrundtypen, die von anderen XAML-Vokabularn oder von der XAML 2009-Spezifikation definiert sind, derzeit in XAML für die Windows-Runtime nicht unterstützt.

Hinweis: Datums- und Uhrzeitangaben (Eigenschaften, die DateTime oder DateTimeOffset, TimeSpan oder System.TimeSpan verwenden) sind nicht mit einem XAML-Grundtyp festgelegt. Diese Eigenschaften sind in XAML in der Regel überhaupt nicht festgelegt, da im Windows-Runtime XAML-Parser für Datums- und Uhrzeitangaben kein Standardverhalten für die Konvertierung von Zeichenfolgen vorhanden ist. Für Initialisierungswerte aller Datums- und Uhrzeiteigenschaften müssen Sie CodeBehind verwenden, der beim Laden einer Seite oder eines Elements ausgeführt wird.