x:Uid-Direktive

Stellt einen eindeutigen Bezeichner für Markupelemente bereit. Bei UWP-XAML (Universelle Windows-Plattform) wird dieser eindeutige Bezeichner für XAML-Lokalisierungsprozesse und -tools verwendet, z. B. beim Verwenden von Ressourcen aus einer RESW-Ressourcendatei.

XAML-Attributsyntax

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

XAML-Werte

Begriff	BESCHREIBUNG
stringID	Eine Zeichenfolge, mit der ein XAML-Element in einer App eindeutig identifiziert wird und die Teil des Ressourcenpfads in einer Ressourcendatei wird. Siehe Hinweise.

Hinweise

Verwenden Sie x:Uid zum Identifizieren eines Objektelements im XAML-Code. Normalerweise ist dieses Objektelement eine Instanz einer Steuerelementklasse oder eines anderen Elements, das auf einer Benutzeroberfläche angezeigt wird. Die Beziehung zwischen der in x:Uid verwendeten Zeichenfolge und den in einer Ressourcendatei verwendeten Zeichenfolgen wird so angegeben, dass die Zeichenfolgen der Ressourcendatei als x:Uid gefolgt von einem Punkt (.) und dann vom Namen einer spezifischen Eigenschaft des Elements, das lokalisiert wird, dargestellt werden. Betrachten Sie das folgende Beispiel:

<Button x:Uid="GoButton" Content="Go"/>

Um Inhalte als Ersatz für den Anzeigetext Go festzulegen, müssen Sie eine neue Ressource aus einer Ressourcendatei angeben. Die Ressourcendatei sollte einen Eintrag für die Ressource mit dem Namen „GoButton.Content“ enthalten. Content ist in diesem Fall eine bestimmte Eigenschaft, die von der Button-Klasse geerbt wird. Sie können auch lokalisierte Werte für die anderen Eigenschaften dieser Schaltfläche bereitstellen, z. B. einen auf einer Ressource basierenden Wert für „GoButton.FlowDirection“. Weitere Informationen zum gemeinsamen Verwenden von x:Uid - und Ressourcendateien finden Sie unter Lokalisieren von Zeichenfolgen in Ihrem UI- und App-Paketmanifest.

Die Gültigkeit der Zeichenfolgen für einen x:Uid-Wert ist in der Praxis davon abhängig, welche Zeichenfolgen als Bezeichner in einer Ressourcendatei und in einem Ressourcenpfad zulässig sind.

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. Darüber hinaus unterliegt x:Name dem XAML-Namescope-Konzept, während die Eindeutigkeit für x:Uid über das Paketressourcenindex-System (PRI) kontrolliert wird. Weitere Informationen finden Sie unter Ressourcenverwaltungssystem.

Die von UWP-XAML verwendeten Regeln für die Eindeutigkeit von x:Uid unterscheiden sich von den Regeln, die bei früheren Technologien mit XAML zum Einsatz kamen. Bei UWP-XAML kann der gleiche ID-Wert vom Typ x:Uid als Direktive für mehrere XAML-Elemente vorhanden sein. In diesem Fall muss allerdings jedes Element dieser Art die gleiche Auflösungslogik verwenden, um die Ressourcen in einer Ressourcendatei aufzulösen. Darüber hinaus verwenden alle XAML-Dateien in einem Projekt den gleichen Ressourcenbereich für die x:Uid-Auflösung. Es gibt kein Konzept, bei dem x:Uid-Bereiche auf einzelne XAML-Dateien ausgerichtet werden.

In einigen Fällen verwenden Sie anstelle der integrierten Funktionen des Paketressourcenindex-Systems (PRI) einen Ressourcenpfad. Jede als x:Uid-Wert verwendete Zeichenfolge definiert einen Ressourcenpfad, der mit „ms-resource:///Resources/“ beginnt und die Zeichenfolge x:Uid enthält. Am Ende des Pfads stehen die Namen der Eigenschaften, die Sie in einer Ressourcendatei oder anderweitig angeben.

Fügen Sie x:Uid nicht in Eigenschaftselemente ein, da dies in Windows-Runtime-XAML nicht zulässig ist.