x:Uid-Direktive

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

identifier

Eine manuell erstellte oder automatisch generierte Zeichenfolge, die in einer Datei eindeutig sein soll, wenn sie von einem x:Uid-Consumer interpretiert wird.

Hinweise

In [MS-XAML] ist x:Uid als Direktive definiert. Weitere Informationen finden Sie unter b[MS-XAML] Abschnitt 5.3.6.

,x:Uid unterscheidet sich von x:Name aufgrund des genannten XAML-Lokalisierungsszenarios, und, damit die zur Lokalisierung verwendeten Bezeichner keine Abhängigkeiten von den Programmiermodellauswirkungen von x:Name haben. Auch wird x:Name von einem XAML-Namescope regiert, wohingegen x:Uid von keinem durch XAML-Sprache definierten Konzept der Eindeutigkeitserzwingung regiert wird. XAML-Prozessoren im allgemeinen Sinn (also Prozessoren, die nicht Teil des Lokalisierungsprozesses sind) sind nicht dafür gedacht, die Eindeutigkeit von x:Uid-Werten durchzusetzen. Diese Verantwortung versteht sich beim Absender der Werte. Die Eindeutigkeit von x:Uid-Werten innerhalb einer einzelnen XAML-Quelle wird von Consumern der Werte erwartet, also zum Beispiel von dedizierten Globalisierungsprozessen oder -tools. Das typische Eindeutigkeitsmodell ist, dass x:Uid-Werte innerhalb einer XML-codierten Datei, die XAML darstellt, eindeutig sind.

Tools, die bedeutendes Wissen eines bestimmten XAML-Schemas haben, können x:Uid nur für wahre lokalisierbare Zeichenfolgen übernehmen statt für alle Fälle, in denen ein Textzeichenfolgenwert in Markup gefunden wird.

Frameworks können in ihrem Objektmodell eine bestimmte Eigenschaft als Alias für x:Uid festlegen, indem das Attributs UidPropertyAttribute für den definierenden Typ übernommen wird. Wenn ein Framework eine bestimmte Eigenschaft angibt, ist es nicht zulässig, x:Uid und den mit einem Alias versehenen Member auf demselben Objekt anzugeben. Wenn x:Uid und der mit einem Alias versehene Member angegeben werden, löst die API der .NET Framework-XAML-Dienste in der Regel XamlDuplicateMemberException für diesen Fall aus.