x:Key-attribut

Identifierar unikt element som skapas och refereras till som resurser och som finns i en ResourceDictionary.

XAML-attributanvändning

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

XAML-attributanvändning (implicit ResourceDictionary)

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

XAML-värden

XamlName-grammatik

Följande är den normativa grammatiken för en sträng som används som en nyckel i Windows Runtime XAML-implementeringen:

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

• Tecken är begränsade till det nedre ASCII-intervallet, och mer specifikt till romerska alfabet med versaler och gemener, siffror och understreck (_).
• Unicode-teckenintervallet stöds inte.
• Ett namn kan inte börja med en siffra.

Anmärkningar

Underordnade element i en ResourceDictionary innehåller vanligtvis ett x:Key-attribut som anger ett unikt nyckelvärde i ordlistan. Nyckel unikhet framtvingas vid inläsning av XAML-processorn. Icke-unika x:Nyckelvärden resulterar i XAML-parsningsfel. När en ej löst nyckel begärts av {StaticResource}-markeringstillägget kommer det också att resultera i XAML-parsningsfel.

x:Key och x:Name är inte identiska begrepp. x:Key används uteslutande i resursordlistor. x:Name används för alla områden i XAML. Ett FindName-anrop med ett nyckelvärde hämtar inte en nyckelresurs. Objekt som definierats i en resursordlista kan ha en x:Key, ett x:Name eller båda. Nyckeln och namnet krävs inte för att matcha.

Observera att i den implicita syntax som visas är ResourceDictionary-objektet implicit i hur XAML-processorn genererar ett nytt objekt för att fylla i en resurssamling .

Kodekvivalenten för att ange x:Key är alla åtgärder som använder en nyckel med den underliggande ResourceDictionary. Till exempel motsvarar en x:Key som används i markeringen för en resurs värdet för nyckelparametern för Insert när du lägger till resursen i en ResourceDictionary.

Ett objekt i en resursordlista kan utelämna ett värde för x:Key om det är ett målformat eller ControlTemplate. I vart och ett av dessa fall är den implicita nyckeln för resursobjektet Värdet TargetType tolkat som en sträng. Mer information finns i XAML-format och ResourceDictionary- och XAML-resursreferenser.