Freigeben über


x:Uid-Direktive

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

XAML-Attributsyntax

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

XAML-Werte

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

Hinweise

Verwenden Sie "x:Uid ", um ein Objektelement in Xaml zu identifizieren. In der Regel handelt es sich bei diesem Objektelement um eine Instanz einer Steuerelementklasse oder eines anderen Elements, das in einer Benutzeroberfläche angezeigt wird. Die Beziehung zwischen der in x:Uid und den Zeichenfolgen, die Sie in einer Ressourcendatei verwenden, besteht darin, dass die Ressourcendateizeichenfolgen die x:Uid gefolgt von einem Punkt (.) und dann durch den Namen einer bestimmten Eigenschaft des Elements sind, das lokalisiert wird. Betrachten Sie das folgende Beispiel:

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

Um Den Anzeigetext Go zu ersetzen, müssen Sie eine neue Ressource angeben, die aus einer Ressourcendatei stammt. Die Ressourcendatei sollte einen Eintrag für die Ressource "GoButton.Content" enthalten. Inhalt in diesem Fall ist eine bestimmte Eigenschaft, die von der Button-Klasse geerbt wird. Sie können auch lokalisierte Werte für andere Eigenschaften dieser Schaltfläche bereitstellen, z. B. einen ressourcenbasierten Wert für "GoButton.FlowDirection". Weitere Informationen zur gemeinsamen Verwendung von x:Uid - und Ressourcendateien finden Sie unter Lokalisieren von Zeichenfolgen in Der Benutzeroberfläche und im App-Paketmanifest.

Die Gültigkeit der Zeichenfolgen, die für einen x:Uid-Wert verwendet werden können, wird in praktischer Weise gesteuert, durch welche Zeichenfolgen als Bezeichner in einer Ressourcendatei und einem Ressourcenpfad zulässig sind.

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 Auswirkungen des Programmiermodells von x:Name haben. Außerdem unterliegt x:Name dem XAML-NameScope-Konzept, während die Eindeutigkeit für x:Uid vom PRI-System (Package Resource Index) gesteuert wird. Weitere Informationen finden Sie unter Ressourcenverwaltungssystem.

UWP-XAML weist etwas andere Regeln für die x:Uid-Eindeutigkeit auf als vorherige verwendete XAML-Nutzungstechnologien. Für UWP-XAML ist es für denselben x:Uid-ID-Wert zulässig, der als Direktive für mehrere XAML-Elemente vorhanden ist. Jedes solche Element muss dann jedoch dieselbe Auflösungslogik verwenden, wenn die Ressourcen in einer Ressourcendatei aufgelöst werden. Außerdem teilen alle XAML-Dateien in einem Projekt einen einzelnen Ressourcenbereich für die x:Uid-Auflösung , es gibt kein Konzept von x:Uid-Bereichen , die an einzelne XAML-Dateien ausgerichtet werden.

In einigen Fällen verwenden Sie anstelle der integrierten Funktionalität des PRI-Systems (Package Resource Index) einen Ressourcenpfad. Jede Zeichenfolge, die als x:Uid-Wert verwendet wird, definiert einen Ressourcenpfad, der mit ms-resource:///Resources/ beginnt und die x:Uid-Zeichenfolge enthält. Der Pfad wird durch die Namen der Eigenschaften abgeschlossen, die Sie in einer Ressourcendatei angeben oder auf andere Weise adressieren.

Platzieren Sie "x:Uid" nicht für Eigenschaftselemente, die in Windows-Runtime XAML nicht zulässig sind.