x:UID direktíva

Egyedi azonosítót biztosít a korrektúraelemekhez. WinUI XAML esetén ezt az egyedi azonosítót használják az XAML honosítási folyamatai és eszközei, például egy .resw erőforrásfájl erőforrásainak használata.

XAML-attribútumok használata

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

XAML-értékek

Időszak	Description
stringID	Egy sztring, amely egyedileg azonosít egy XAML-elemet egy alkalmazásban, és az erőforrásfájl erőforrás-elérési útjának részévé válik. Lásd: Megjegyzések.

Megjegyzések

Az XAML objektumelemének azonosításához használja az x:Uid azonosítót . Ez az objektumelem általában egy vezérlőosztály vagy más elem egy példánya, amely egy felhasználói felületen jelenik meg. Az x:Uid azonosítóban használt karakterláncok és az erőforrás fájlban használt karakterláncok közötti kapcsolat az, hogy az erőforrás fájl karakterláncai az x:Uid-zal kezdődnek, amit egy pont (.) követ, majd a honosított elem adott tulajdonságának neve. Fontolja meg ezt a példát:

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

Az Ugrás megjelenítési szöveg helyére beírt tartalom megadásához meg kell adnia egy erőforrásfájlból származó új erőforrást. Az erőforrásfájlnak tartalmaznia kell egy bejegyzést a "GoButton.Content" nevű erőforráshoz. Ebben az esetben a tartalom egy adott tulajdonság, amelyet a Gomb osztály örököl. A gomb más tulajdonságaihoz is megadhat honosított értékeket, például megadhat egy erőforrás-alapú értéket a "GoButton.FlowDirection" számára. További információ az x:Uid és az erőforrásfájlok együttes használatáról: Sztringek honosítása a felhasználói felületen és az alkalmazáscsomag-jegyzékben.

Az x:Uid értékhez használható sztringek érvényességét gyakorlati értelemben szabályozza, hogy a sztringek az erőforrásfájlban és az erőforrás elérési útjának azonosítójaként legálisak legyenek.

x:Uid különálló az x:Name-től a megadott XAML-honosítási forgatókönyv miatt, és azért, hogy a honosításhoz használt azonosítók ne függjenek az x:Name programozási modell következményeitől. Az x:Name függvényt az XAML-névszkóp koncepciója szabályozza, míg az x:Uid egyediségét a csomagerőforrás-index (PRI) rendszere szabályozza. További információ: Erőforrások kezelése AZ MRT Core - és erőforrás-kezelési rendszerrel.

A Windows-futtatókörnyezet XAML-nek némileg eltérő szabályai vannak az x:Uid egyediségére, mint a korábbi XAML-használó technológiákra. A Windows Runtime XAML esetében az x:Uid azonosító értéke jogi okokból több XAML-elem irányelveként is létezhet. Az erőforrások erőforrásfájlban való feloldásakor azonban minden ilyen elemnek ugyanazt a feloldási logikát kell használnia. Emellett a projekt összes XAML-fájlja egyetlen erőforrás-hatókörrel rendelkezik az x:Uid felbontás érdekében, az x:Uid hatókörök nem igazodnak az egyes XAML-fájlokhoz.

Bizonyos esetekben a csomagerőforrás-index (PRI) rendszer beépített funkciói helyett egy erőforrás-elérési utat fog használni. Az x:Uid értékként használt karakterláncok olyan erőforrás-elérési utat határoznak meg, amely az ms-resource:///Resources/ értékkel kezdődik, és tartalmazza az x:Uid sztringet . Az elérési utat a tulajdonságok nevei képezik, amelyeket az erőforrásfájlban határoz meg, vagy másképp megcélzott.

Ne helyezzen x:Uid azonosítót a Windows-futtatókörnyezet XAML-ben nem engedélyezett tulajdonságelemekre.