x:Property-Anweisung
Deklariert eine XAML-Eigenschaft in Markup.
Verwendung von XAML-Objektelementen
<object x:Class="className">
<x:Members>
<x:Property Name="propertyName" Type="propertyType"/>
additionalProperties
</x:Members>
</object>
XAML-Werte
Wert | Beschreibung |
---|---|
className |
Der Name der Sicherungsklasse oder partiellen Klasse für die XAML-Produktion. |
propertyName |
Der Membername der Eigenschaft, die definiert wird. |
propertyType |
Der Typname (oder eine andere Zeichenfolgenform, frameworkspezifisch), der den Typ dieser Eigenschaft angibt. |
Hinweise
In Implementierungen von .NET-XAML-Diensten hat x:Property
keine direkte Typunterstützung, wird jedoch durch die PropertyDefinition-Klasse unterstützt. In einem XAML-Knotenstream wird ein x:Property
-Element als ein Member namens Property
aus dem XAML-Namespace der XAML-Sprache dargestellt. Der Member Property
enthält Attribute gemäß Deklaration durch Markup.
Die Bedeutungen von Name
und Type
werden nicht auf der Ebene der .NET-XAML-Dienste zugewiesen. Sie sind im ursprünglichen XAML-Knotenstream als Zeichenfolgenwerte gespeichert, um später gemäß den Regeln interpretiert zu werden, die möglicherweise von bestimmten Frameworks erzwungen werden. Die Bedeutung kann, je nach Implementierung, an der Bedeutung eines XAML-Namens oder eines XAML-Typs ausgerichtet werden oder kann nur in einem Unterstützungstypsystem gültig sein.
Damit eine praktische Verwendung von x:Members
als Mittel zum Angeben von Memberdefinitionen in Markup unterstützt wird, müssen die Member einer Klasse zugeordnet sein, die geändert werden kann. Das beabsichtigte Modell besteht darin, dass x:Members
als ein Member eines Typs vorhanden ist, der eine x:Class
angibt. Der Mechanismus zum Zuordnen von Typen und Membern oder zum Erstellen von dynamischen Memberdefinitionen wird jedoch auf der Ebene der .NET-XAML-Dienste nicht unterstützt. Dies wird von einzelnen Frameworks übernommen, die Anwendungsmodelle haben, die Memberdefinitionen von XAML unterstützen. In der Regel sind, damit dieses Feature unterstützt wird, MSBUILD-Buildvorgänge erforderlich, die XAML als Markup kompilieren und es als CodeBehind integrieren oder reine Von-XAML-Assemblys generieren.
x:Property für Windows Workflow Foundation
Für Windows Workflow Foundation definiert x:Property
die Member einer benutzerdefinierten Aktivität, die vollständig in XAML erstellt ist, oder XAML-definierte dynamische Member für einen Aktivitäts-Designer mit CodeBehind.
x:Class
muss auch für das Stammelement der XAML-Produktion angegeben werden. Dies ist keine Anforderung auf der Ebene der .NET-XAML-Dienste, wird jedoch eine Anforderung, wenn die XAML-Produktion von MSBUILD-Buildvorgängen geladen wird, die benutzerdefinierte Aktivitäten und Windows Workflow Foundation-XAML im Allgemeinen unterstützen. Windows Workflow Foundation verwendet nicht den reinen XAML-Typnamen als beabsichtigten Wert für das x:Property
-Attribut Type
, sondern stattdessen eine Konvention, die hier nicht dokumentiert ist. Weitere Informationen finden Sie unter DynamicActivity-Erstellung.
.NET Desktop feedback