x:Kulcsattribútum

Egyedileg azonosítja az erőforrásokként létrehozott és hivatkozott elemeket, amelyek egy ResourceDictionary-ben léteznek.

XAML-attribútumok használata

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

XAML attribútumhasználat (implicit ResourceDictionary)

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

XAML-értékek

Időszak	Description
objektum	Bármely megosztható objektum. Lásd : ResourceDictionary és XAML erőforráshivatkozások.
stringKeyValue	Kulcsként használt igazi string, amelynek meg kell felelnie az XamlName> nyelvtani szabályainak. Lásd alább a "XamlName nyelvhelyesség" című témakört.

XamlName nyelvhelyesség

A Windows Runtime XAML-implementációjában kulcsként használt karakterlánc normatív nyelvtana a következő:

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

• A karakterek az alsó ASCII-tartományra, pontosabban a római ábécé nagybetűire és kisbetűire, számjegyeire és aláhúzásjelére (_) korlátozódnak.
• A Unicode karaktertartomány nem támogatott.
• A név nem kezdődhet számjegyekkel.

Megjegyzések

A ResourceDictionary gyermekelemei általában tartalmaznak egy x:Key attribútumot, amely egy egyedi kulcsértéket határoz meg a szótárban. A kulcs egyediségét az XAML processzor terheléskor kényszeríti ki. A nem egyedi x:Kulcsértékek XAML-elemzési kivételeket eredményeznek. Ha a {StaticResource} korrektúrakiterjesztés kéri, a nem feloldott kulcs XAML-elemzési kivételeket is eredményez.

x:Kulcs és x:A név nem azonos fogalmak. x:A kulcs kizárólag az erőforrás-szótárakban használatos. x:A név az XAML minden területén használatos. A kulcsértékkel rendelkező FindName-hívások nem kérnek le kulcsos erőforrást. Az erőforrás-szótárban definiált objektumok lehetnek x:kulcs, x:név vagy mindkettő. A kulcsnak és a névnek nem kell egyeznie.

Vegye figyelembe, hogy az implicit szintaxisban a ResourceDictionary objektum implicit módon jelenik meg abban, hogy az XAML-processzor hogyan állít elő új objektumot egy erőforráscsoport feltöltéséhez.

Az x:Kulcs megadásának kódegyenértéke minden olyan művelet, amely a mögöttes ResourceDictionary kulcsát használja. Például az erőforrás jelölőjében alkalmazott x:Key egyenértékű a key paraméter értékével az Insert-ben, amikor hozzáadja az erőforrást a ResourceDictionary-hez.

Az erőforrás-szótárban lévő elemek kihagyhatnak egy x:Key értéket, ha célként megadott stílusról vagy ControlTemplate-ról van szó; ezekben az esetekben az erőforráselem implicit kulcsa a Sztringként értelmezett TargetType érték. További információ: XAML-stílusok , ResourceDictionary és XAML-erőforráshivatkozások.