Freigeben über

x:Class-Attribut

Konfiguriert die XAML-Kompilierung, um partielle Klassen zwischen Markup und CodeBehind zu verbinden. Die Partielle Codeklasse wird in einer separaten Codedatei definiert, und die partielle Markupklasse wird während der XAML-Kompilierung durch die Codegenerierung erstellt.

XAML-Attributverwendung

<object x:Class="namespace.classname"...>
  ...
</object>

XAML-Werte

Begriff Description
namespace Wahlfrei. Gibt einen Namespace an, der die partielle Klasse enthält, die durch den Klassennamen identifiziert wird. Wenn ein Namespace angegeben ist, trennt ein Punkt (.) den Namespace und den Klassennamen. Wenn der Namespace nicht angegeben wird, ist angenommen, dass classname keinen Namespace hat.
Classname Erforderlich. Gibt den Namen der partiellen Klasse an, die das geladene XAML und den Code-Behind für dieses XAML verbindet.

Bemerkungen

x:Class kann als Attribut für jedes Element deklariert werden, das der Stamm einer XAML-Datei-/Objektstruktur ist und durch Buildaktionen kompiliert wird, oder für den Anwendungsstamm in der Anwendungsdefinition einer kompilierten Anwendung. Das Deklarieren von x:Class für ein anderes Element als einen Wurzelknoten und unter jeglichen Umständen für eine XAML-Datei, die nicht mit der Buildaktion "Seite" kompiliert wird, führt zu einem Kompilierfehler.

Die als "x:Class " verwendete Klasse kann keine geschachtelte Klasse sein.

Der Wert des x:Class-Attributs muss eine Zeichenfolge sein, die den vollqualifizierten Namen einer Klasse angibt. Sie können Namespace-Informationen weglassen, solange der Code-Behind entsprechend strukturiert ist (Ihre Klassendefinition beginnt auf der Klassenebene). Die CodeBehind-Datei für eine Seite oder Anwendungsdefinition muss sich in einer Codedatei befinden, die als Teil des Projekts enthalten ist. Die Code-Behind-Klasse muss öffentlich sein. Die CodeBehind-Klasse muss partial sein.

CLR-Sprachregeln

Obwohl Ihre CodeBehind-Datei eine C++-Datei sein kann, gibt es bestimmte Konventionen, die weiterhin dem CLR-Sprachformular entsprechen, sodass es keinen Unterschied in der XAML-Syntax gibt. Insbesondere ist das Trennzeichen zwischen dem Namespace und den Klassennamenkomponenten eines beliebigen x:Class-Werts immer ein Punkt ("."), obwohl das Trennzeichen zwischen Namespace und Klassenname in der dem XAML-Code zugeordneten C++-Codedatei "::" lautet. Wenn Sie geschachtelte Namespaces in C++ deklarieren, sollte das Trennzeichen zwischen den aufeinander folgenden geschachtelten Namespacezeichenfolgen auch "." statt "::" sein, wenn Sie den Namespaceteil des x:Class-Werts angeben.

  • Last updated on