FrameworkContentElement.Name Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Obtient ou définit le nom d’identification de l’élément. Le nom fournit une référence d’instance afin que le code-behind programmatique, tel que le code du gestionnaire d’événements, puisse faire référence à un élément une fois qu’il est construit lors de l’analyse du code 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

Valeur de propriété

String

Nom de l'élément.

Implémente

Name

Attributs

LocalizabilityAttribute

Remarques

L’utilisation la plus courante de cette propriété est la spécification d’un nom d’élément XAML dans le balisage.

Cette propriété fournit essentiellement une propriété pratique au niveau de l’infrastructure WPF pour définir la directive XAML x:Name.

L’obtention d’un code à partir d’un Name code n’est pas courante, car si vous disposez déjà de la référence appropriée dans le code, vous pouvez simplement appeler des méthodes et des propriétés sur la référence d’élément et n’en avez généralement pas besoin Name. Une exception est si la chaîne a une signification surchargée, par exemple s’il est utile d’afficher ce nom dans l’interface utilisateur. La définition d’un Name code si l’original Name a été défini à partir du balisage n’est pas recommandée, et la modification de la propriété ne modifie pas la référence d’objet. Ces références d’objet sont créées uniquement lorsque les portées de noms sous-jacentes sont créées explicitement pendant le chargement XAML.

Vous devez spécifiquement appeler RegisterName pour apporter une modification effective à la Name propriété d’un élément déjà chargé.

L’un des cas notables où la définition Name à partir du code est importante consiste à nommer les éléments sur lesquels les storyboards s’exécutent. Avant de pouvoir inscrire un nom, il peut également être nécessaire d’instancier et d’affecter une NameScope instance. Consultez la section Exemple ou vue d’ensemble des storyboards.

La définition Name à partir du code a des applications limitées, mais la recherche d’un élément par nom est plus courante, en particulier si vous utilisez un modèle de navigation où les pages rechargent dans l’application et le code d’exécution n’est pas nécessairement le code-behind de cette page respective. La méthode FindNameutilitaire, disponible à partir de n’importe quel élément, peut trouver n’importe FrameworkContentElementquel élément Name dans l’arborescence logique de cet élément de manière récursive. Vous pouvez également utiliser la FindLogicalNode méthode statique de LogicalTreeHelper, qui prend également la Name chaîne en tant qu’argument.

Les éléments racines couramment utilisés (WindowPagepar exemple) implémentent l’interfaceINameScope. Les implémentations de cette interface sont censées appliquer que les noms soient non ambigus dans leur étendue.

Informations sur les propriétés de dépendance

Champ d’identificateur	NameProperty
Propriétés de métadonnées définies sur true	IsAnimationProhibited

Voir aussi

• NameScope