x:Uid-Anweisung

  • Artikel

Stellt einen eindeutigen Bezeichner für Markupelemente bereit. In vielen Szenarien wird dieser eindeutige Bezeichner von XAML-Lokalisierungsprozessen und -Tools verwendet.

Verwendung von XAML-Attributen

<object x:Uid="identifier"... />

XAML-Werte

Wert BESCHREIBUNG
identifier Eine manuell erstellte oder automatisch generierte Zeichenfolge, die in einer Datei eindeutig sein sollte, wenn sie von einem x:Uid--Consumer interpretiert wird.

Hinweise

In [MS-XAML] wird x:Uid als Richtlinie definiert. Weitere Informationen finden Sie unter [MS-XAML] Abschnitt 7.3.6.

x:Uid wird getrennt von x:Name behandelt – zum einen aufgrund des angegebenen XAML-Lokalisierungsszenarios, zum anderen, damit für die Lokalisierung verwendete Bezeichner nicht von den Programmiermodellaspekten des x:Name-Elements abhängig sind. Außerdem unterliegt x:Name dem XAML-Namensraum, jedoch unterliegt x:Uid nicht dem in der XAML-Sprache definierten Konzept der Durchsetzung der Eindeutigkeit. XAML-Prozessoren in einem breiten Sinne (Prozessoren, die nicht Teil des Lokalisierungsprozesses sind) werden nicht erwartet, die Eindeutigkeit von x:Uid-Werten zu erzwingen. Diese Verantwortung ist konzeptionell auf dem Ursprung der Werte. Die Erwartung der Eindeutigkeit von Werten innerhalb einer einzelnen XAML-Quelle ist für Verbraucher der x:Uid-Werte sinnvoll, z. B. dedizierte Globalisierungsprozesse oder Tools. Das typische Einzigartigkeitsmodell ist, dass x:Uid-Werte innerhalb einer XML-kodierten Datei, die XAML darstellt, eindeutig sind.

Tools, die über umfangreiche Kenntnisse eines bestimmten XAML-Schemas verfügen, können sich dafür entscheiden, x:Uid nur für echte lokalisierbare Zeichenfolgen anzuwenden, anstatt für alle Fälle, in denen ein Textstring-Wert im Markup vorkommt.

Frameworks können eine bestimmte Eigenschaft in ihrem Objektmodell als Alias für x:Uid festlegen, indem sie das UidPropertyAttribute-Attribut auf den definierenden Typ anwenden. Wenn ein Framework eine bestimmte Eigenschaft angibt, ist es ungültig, sowohl x:Uid als auch das Aliaselement desselben Objekts anzugeben. Wenn sowohl x:Uid als auch das Aliaselement angegeben werden, wird die .NET XAML Services-API in der Regel für diesen Fall ausgelöst XamlDuplicateMemberException .

Hinweise zur WPF-Verwendung

Weitere Informationen über die Rolle von x:Uid im WPF-Lokalisierungsprozess und in der BAML-Form von XAML finden Sie unter Globalisierung für WPF oder Uid

Weitere Informationen