FrameworkContentElement.Name Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Property Name As StringValeur de propriété
Nom de l'élément.
Implémente
- Attributs
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 |