x:Uid direktif

Menyediakan pengidentifikasi unik untuk elemen markup. Untuk WinUI XAML, pengidentifikasi unik ini digunakan oleh proses dan alat pelokalan XAML, seperti menggunakan sumber daya dari file sumber daya .resw.

Penggunaan atribut XAML

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

Nilai XAML

Istilah	Deskripsi
stringID	String yang secara unik mengidentifikasi elemen XAML dalam aplikasi, dan menjadi bagian dari jalur sumber daya dalam file sumber daya. Lihat Komentar.

Komentar

Gunakan x:Uid untuk mengidentifikasi elemen objek di XAML Anda. Biasanya elemen objek ini adalah instans kelas kontrol atau elemen lain yang ditampilkan dalam UI. Hubungan antara string yang Anda gunakan di x:Uid dan string yang Anda gunakan dalam file sumber daya adalah bahwa string file sumber daya adalah x:Uid diikuti oleh titik (.) lalu dengan nama properti tertentu dari elemen yang sedang dilokalkan. Pertimbangkan contoh ini:

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

Untuk menentukan konten untuk mengganti teks tampilan Buka, Anda harus menentukan sumber daya baru yang berasal dari file sumber daya. File sumber daya Anda harus berisi entri untuk sumber daya bernama "GoButton.Content". Konten dalam hal ini adalah properti tertentu yang diwarisi oleh kelas Tombol . Anda mungkin juga menyediakan nilai yang dilokalkan untuk properti lain dari tombol ini, misalnya Anda dapat memberikan nilai berbasis sumber daya untuk "GoButton.FlowDirection". Untuk informasi selengkapnya tentang cara menggunakan x:Uid dan file sumber daya bersama-sama, lihat Melokalisasi string di manifes paket UI dan aplikasi Anda.

Validitas string mana yang dapat digunakan untuk nilai x:Uid dikendalikan dalam praktiknya oleh string mana yang dianggap legal sebagai pengidentifikasi di dalam file dan jalur sumber daya.

x:Uid diskrit dari x:Name keduanya karena skenario pelokalan XAML yang dinyatakan, dan sehingga pengidentifikasi yang digunakan untuk pelokalan tidak memiliki dependensi pada implikasi model pemrograman x:Name. Selain itu, x:Name diatur oleh konsep namescope XAML, sedangkan keunikan untuk x:Uid dikendalikan oleh sistem indeks sumber daya paket (PRI). Untuk informasi selengkapnya, lihat Mengelola sumber daya dengan MRT Core dan Sistem Manajemen Sumber Daya.

Windows Runtime XAML memiliki aturan yang agak berbeda untuk keunikan x:Uid daripada teknologi pemanfaatan XAML sebelumnya yang digunakan. Untuk Windows Runtime XAML, nilai x:Uid ID yang sama dapat ada sebagai arahan pada beberapa elemen XAML. Namun, setiap elemen tersebut kemudian harus berbagi logika resolusi yang sama saat menyelesaikan sumber daya dalam file sumber daya. Selain itu, semua file XAML dalam proyek berbagi cakupan sumber daya tunggal untuk tujuan resolusi x:Uid , tidak ada konsep cakupan x:Uid yang selaras dengan file XAML individual.

Dalam beberapa kasus, Anda akan menggunakan jalur sumber daya daripada fungsionalitas bawaan sistem indeks sumber daya paket (PRI). Setiap string yang digunakan sebagai nilai x:Uid mendefinisikan jalur sumber daya yang dimulai dengan ms-resource:///Resources/ dan menyertakan string x:Uid . Jalur dilengkapi dengan nama properti yang Anda tentukan dalam berkas sumber daya atau yang sedang menjadi target.

Jangan letakkan x:Uid pada elemen properti, yang tidak diizinkan di Windows Runtime XAML.