x:Atributo chave

Identifica exclusivamente elementos que são criados e referenciados como recursos e que existem dentro de um ResourceDictionary.

Uso de atributos XAML

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

Uso do atributo XAML ( ResourceDictionary implícito)

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

Valores XAML

Term	Description
objecto	Qualquer objeto que seja compartilhável. Consulte ResourceDictionary e referências de recursos XAML.
stringKeyValue	Uma cadeia de caracteres verdadeira usada como uma chave, que deve estar em conformidade com a gramática XamlName> . Consulte "XamlName grammar" abaixo.

Gramática XamlName

A seguir está a gramática normativa para uma sequência usada como chave na implementação XAML do Windows Runtime:

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

• Os caracteres são restritos ao intervalo ASCII inferior e, mais especificamente, às letras maiúsculas e minúsculas do alfabeto latino, dígitos e o caractere sublinhado (_).
• O intervalo de caracteres Unicode não é suportado.
• Um nome não pode começar com um dígito.

Observações

Os elementos filho de um ResourceDictionary geralmente incluem um atributo x:Key que especifica um valor de chave exclusivo dentro desse dicionário. A unicidade da chave é imposta no momento do carregamento pelo processador XAML. Os valores x:Key não exclusivos resultarão em exceções de análise XAML. Se solicitado pela extensão de marcação {StaticResource}, uma chave não resolvida também resultará em exceções de análise XAML.

x:Key e x:Name não são conceitos idênticos. x:Key é usado exclusivamente em dicionários de recursos. x:Name é usado para todas as áreas de XAML. Uma chamada FindName usando um valor de chave não recuperará um recurso com chave. Os objetos definidos em um dicionário de recursos podem ter um x:Key, um x:Name ou ambos. A chave e o nome não precisam de corresponder.

Observe que, na sintaxe implícita mostrada, o objeto ResourceDictionary está implícito em como o processador XAML produz um novo objeto para preencher uma coleção Resources .

O código equivalente a especificar x:Key é qualquer operação que usa uma chave com o ResourceDictionary subjacente. Por exemplo, um x:Key aplicado na marcação de um recurso é equivalente ao valor do parâmetro key de Insert quando você adiciona o recurso a um ResourceDictionary.

Um item em um dicionário de recursos pode omitir um valor para x:Key se for um Style ou ControlTemplate de destino; em cada um desses casos, a chave implícita do item de recurso é o valor TargetType interpretado como uma cadeia de caracteres. Para saber mais, veja Estilos XAML e referências de recursos ResourceDictionary e XAML.