x:Uid-Direktive

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

XAML-Attributverwendung

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

XAML-Werte

Bemerkungen

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 Zeichenfolge, die Sie in x:Uid verwenden, und den Zeichenfolgen, die Sie in einer Ressourcendatei verwenden, liegt darin, dass die Zeichenfolgen in der Ressourcendatei aus dem x:Uid bestehen, gefolgt von einem Punkt (.) und dem Namen einer spezifischen Eigenschaft des Elements, das lokalisiert wird. Betrachten Sie dieses 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 Verwalten von Ressourcen mit MRT Core and Resource Management System.

Windows-Runtime-XAML weist etwas andere Regeln für die x:Uid-Eindeutigkeit auf als vorherige verwendete XAML-Nutzungstechnologien. Für Windows-Runtime-XAML ist es zulässig, dass derselbe x: Uid-ID-Wert 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.

Setzen Sie "x:Uid" nicht auf Eigenschaftselementen ein, da dies in Windows-Runtime-XAML nicht zulässig ist.