x:Atribut kunci

Secara unik mengidentifikasi elemen yang dibuat dan direferensikan sebagai sumber daya, dan yang ada dalam ResourceDictionary.

Penggunaan atribut XAML

<ResourceDictionary>
  <object x:Key="stringKeyValue".../>
</ResourceDictionary>

Penggunaan atribut XAML (implisit ResourceDictionary)

<object.Resources>
  <object x:Key="stringKeyValue".../>
</object.Resources>

Nilai XAML

Istilah	Description
objek	Objek apa pun yang dapat dibagikan. Lihat ResourceDictionary dan Referensi Sumber Daya XAML.
stringKeyValue	String yang valid digunakan sebagai kunci, yang harus sesuai dengan tata bahasa XamlName>. Lihat "Tata bahasa XamlName" di bawah ini.

Tata bahasa XamlName

Berikut ini adalah tata bahasa normatif untuk string yang digunakan sebagai kunci dalam implementasi Windows Runtime XAML:

XamlName ::= NameStartChar (NameChar)*
NameStartChar ::= LetterCharacter | '_'
NameChar ::= NameStartChar | DecimalDigit
LetterCharacter ::= ('a'-'z') | ('A'-'Z')
DecimalDigit ::= '0'-'9'
CombiningCharacter::= none

• Karakter dibatasi untuk rentang ASCII yang lebih rendah, dan lebih khusus untuk huruf besar alfabet Romawi dan huruf kecil, digit, dan karakter garis bawah (_).
• Rentang karakter Unicode tidak didukung.
• Nama tidak dapat dimulai dengan digit.

Komentar

Elemen turunan dari ResourceDictionary umumnya menyertakan atribut x:Key yang menentukan nilai kunci unik dalam kamus tersebut. Keunikan kunci ditegakkan saat pemuatan oleh prosesor XAML. Nilai x:Key yang tidak unik akan menghasilkan pengecualian penguraian XAML. Jika diminta oleh ekstensi markup {StaticResource}, kunci yang tidak diselesaikan juga akan menghasilkan pengecualian penguraian XAML.

x:Key dan x:Name bukan konsep yang identik. x:Key digunakan secara eksklusif dalam kamus sumber daya. x:Name digunakan untuk semua area XAML. Panggilan FindName menggunakan nilai kunci tidak akan mengambil sumber daya kunci. Objek yang ditentukan dalam kamus sumber daya mungkin memiliki x:Key, x:Name atau keduanya. Kunci dan nama tidak harus cocok.

Perhatikan bahwa dalam sintaks implisit yang ditampilkan, objek ResourceDictionary adalah implisit dalam cara prosesor XAML menghasilkan objek baru untuk mengisi koleksi Sumber Daya .

Kode yang setara dengan menentukan x:Key adalah operasi apa pun yang menggunakan kunci dengan ResourceDictionary yang mendasarinya. Misalnya, x:Key yang diterapkan dalam markup untuk sumber daya setara dengan nilai parameter kunciSisipkan saat Anda menambahkan sumber daya ke ResourceDictionary.

Item dalam kamus sumber daya dapat menghilangkan nilai untuk x:Key jika merupakan Gaya atau ControlTemplate yang ditargetkan; dalam setiap kasus ini, kunci implisit item sumber daya adalah nilai TargetType yang ditafsirkan sebagai string. Untuk informasi selengkapnya, lihat gaya XAML dan referensi sumber daya ResourceDictionary dan XAML.