Freigeben über

x:Uid-Direktive

  • Artikel

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

XAML-Attributverwendung

<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.

Bemerkungen

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

x:Uid ist sowohl aufgrund des angegebenen XAML-Lokalisierungsszenarios als auch von x:Name getrennt, sodass Bezeichner, die für die Lokalisierung verwendet werden, keine Abhängigkeiten von den Programmiermodellauswirkungen x:Namehaben. Darüber hinaus unterliegt x:Name dem XAML-NameScope; x:Uid wird jedoch nicht durch ein xaml-sprachdefiniertes Konzept der Eindeutigkeitserzwingung gesteuert. XAML-Prozessoren werden in einem breiten Sinne (Prozessoren, die nicht Teil des Lokalisierungsprozesses sind) nicht erwartet, die Eindeutigkeit von x:Uid Werten zu erzwingen. Diese Verantwortung liegt konzeptionell auf dem Absender der Werte. Die Erwartung der Eindeutigkeit von x:Uid Werten innerhalb einer einzelnen XAML-Quelle ist für Verbraucher der Werte angemessen, z. B. dedizierte Globalisierungsprozesse oder Tools. Das typische Eindeutigkeitsmodell besteht darin, dass x:Uid Werte innerhalb einer XML-codierten Datei eindeutig sind, die XAML darstellt.

Tools mit erheblichem Wissen über ein bestimmtes XAML-Schema können auswählen, x:Uid nur für echte lokalisierbare Zeichenfolgen anzuwenden, statt für alle Fälle, in denen im Markup ein Textzeichenfolgenwert auftritt.

Frameworks können eine bestimmte Eigenschaft in ihrem Objektmodell als Alias für x:Uid angeben, indem das Attribut UidPropertyAttribute auf den definierenden Typ angewendet wird. Wenn ein Framework eine bestimmte Eigenschaft angibt, ist es ungültig, sowohl x:Uid als auch das aliasierte Element für dasselbe Objekt anzugeben. Wenn sowohl x:Uid als auch das aliasierte Element angegeben werden, löst die .NET XAML Services-API in der Regel XamlDuplicateMemberException für diesen Fall aus.

WPF-Verwendungshinweise

Weitere Informationen zur Rolle von x:Uid im WPF-Lokalisierungsprozess und in DER BAML-Form von XAML finden Sie unter Globalization for WPF oder Uid

Siehe auch