direktif x:Uid

Menyediakan pengidentifikasi unik untuk elemen markup. Untuk Platform Windows Universal (UWP) 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 Keterangan.

Keterangan

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 dalam 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 Go, 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 memberikan 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 Melokalkan string di UI dan manifes paket aplikasi Anda.

Validitas string mana yang dapat digunakan untuk nilai x:Uid dikontrol dalam arti praktis di mana string legal sebagai pengidentifikasi dalam file sumber daya dan jalur sumber daya.

x:Uid berbeda 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 Sistem Manajemen Sumber Daya.

UWP XAML memiliki aturan yang agak berbeda untuk keunikan x:Uid daripada teknologi pemanfaatan XAML sebelumnya yang digunakan. Untuk UWP XAML, nilai ID x:Uid yang sama berlaku 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 diselaraskan dengan file XAML individual.

Dalam beberapa kasus, Anda akan menggunakan jalur sumber daya daripada fungsionalitas bawaan sistem indeks sumber daya paket (PRI). String apa pun yang digunakan sebagai nilai x:Uid mendefinisikan jalur sumber daya yang dimulai dengan ms-resource:///Resources/ dan menyertakan string x:Uid . Jalur diselesaikan dengan nama properti yang Anda tentukan dalam file sumber daya atau ditargetkan.

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