FrameworkContentElement.Name Свойство

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

Возвращает или задает идентификатор имени элемента. Имя предоставляет ссылку на экземпляр, чтобы программный код программной части, например код обработчика событий, может ссылаться на элемент после его создания во время анализа XAML.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public string Name { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
member this.Name : string with get, set

Public Property Name As String

Значение свойства

String

Имя элемента.

Реализации

Name

Атрибуты

LocalizabilityAttribute

Комментарии

Чаще всего это свойство используется при указании имени элемента XAML в разметке.

Это свойство по сути предоставляет удобное свойство платформы WPF для задания директивы XAML x:Name.

Name Получение из кода не распространено, так как если у вас уже есть соответствующая ссылка в коде, вы можете просто вызывать методы и свойства в ссылке на элемент и обычно не нуждаться Nameв них. Исключение заключается в том, что строка имеет некоторое перегруженное значение, например, если это полезно для отображения этого имени в пользовательском интерфейсе. Если исходный NameName код был задан из разметки, также не рекомендуется, а изменение свойства не изменит ссылку на объект. Такие ссылки на объекты создаются только при явном создании базовых областей имен во время загрузки XAML.

Необходимо специально вызвать RegisterName эффективное изменение Name свойства уже загруженного элемента.

Один из важных случаев, когда параметр Name из кода важен для именования элементов, которые будут выполняться раскадровки. Прежде чем зарегистрировать имя, может потребоваться создать экземпляр и назначить NameScope экземпляр. См. раздел "Пример" или "Обзор раскадровки".

Настройка Name из кода имеет ограниченные приложения, но поиск элемента по имени более распространен, особенно если вы используете модель навигации, где страницы перезагружаются в приложение, и код времени выполнения не обязательно является кодом соответствующей страницы. Метод FindNameслужебной программы, доступный из любого FrameworkContentElementэлемента, может найти любой элемент Name в логическом дереве этого элемента рекурсивно. Или можно использовать статический FindLogicalNode метод LogicalTreeHelper, который также принимает Name строку в качестве аргумента.

Часто используемые корневые элементы (Windowнапример, Page например) реализуют интерфейс INameScope. Предполагается, что реализации этого интерфейса будут применяться, чтобы имена были однозначно определены в их области.

Сведения о свойстве зависимостей

Элемент	Ценность
Поле идентификатора	NameProperty
Свойства метаданных, равные свойству true	IsAnimationProhibited

См. также раздел

• NameScope