x:Uid-Anweisung
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
.NET Desktop feedback