Атрибут x:Key

Уникально идентифицирует элементы, созданные и на которые ссылаются как ресурсы, и которые существуют в ResourceDictionary.

Использование атрибута XAML

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

Использование атрибута XAML (неявный ResourceDictionary)

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

Значения XAML

Срок	Описание
object	Любой объект, доступный для совместного использования. См. ссылки на ресурсы ResourceDictionary и XAML.
stringKeyValue	Строка true, используемая в качестве ключа, которая должна соответствовать грамматике XamlName> . См. раздел "Грамматика XamlName" ниже.

Грамматика XamlName

Ниже приведена нормативная грамматика для строки, которая используется в качестве ключа в реализации среда выполнения Windows XAML:

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

• Символы ограничены диапазоном нижней части ASCII, а именно: прописными и строчными буквами латинского алфавита, цифрами и символом подчеркивания (_).
• Диапазон символов Юникода не поддерживается.
• Имя не может начинаться с цифры.

Remarks

Дочерние элементы ResourceDictionary обычно включают атрибут x:Key , указывающий уникальное значение ключа в этом словаре. Уникальность ключей обеспечивается обработчиком XAML во время загрузки. Не уникальные значения x:Key приводят к исключениям синтаксического анализа XAML. Если используется расширение разметки {StaticResource}, неразрешённый ключ также приведёт к исключениям при разборе XAML.

X:Key и x:Name не являются идентичными понятиями. x:Key используется исключительно в словарях ресурсов. x:Name используется для всех областей XAML. Вызов FindName , использующий значение ключа, не извлекает ресурс с ключом. Объекты, определенные в словаре ресурсов, могут иметь x:Key, x:Name или оба. Ключ и имя не требуются для сопоставления.

Обратите внимание, что в показанном неявном синтаксисе объект ResourceDictionary подразумевается тем, как обработчик XAML создает новый объект для заполнения коллекции Resources.

Эквивалентом указания x:Key в коде служит любая операция, использующая ключ в базовом ResourceDictionary. Например, x:Key , примененный в разметке ресурса, эквивалентен значению ключевого параметра Insert при добавлении ресурса в ResourceDictionary.

Элемент в словаре ресурсов может опустить значение x:Key , если оно является целевым стилем или ControlTemplate; В каждом из этих случаев неявным ключом элемента ресурса является значение TargetType , интерпретируемое как строка. Дополнительные сведения см. в статье "Стили XAML " и ссылки на ресурсы ResourceDictionary и XAML.