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.