ElementName, propriété

Binding.ElementName Property

Obtient ou définit le nom de l'élément à utiliser comme objet de source de liaison pour la Binding.

Syntaxe


public string ElementName { get; set; }


<Binding ElementName="nameString"/>

XAML Values

nameString

Valeur de la propriété Name ou l'attribut x:Name pour l'élément intéressant.

Valeur de propriété

Type: System.String [.NET] | Platform::String [C++]

La valeur de la propriété Name ou l'attribut x:Name de l'élément auquel établir la liaison. La valeur par défaut correspond à la valeur null.

Remarques

Lorsque vous définissez cette propriété, la valeur spécifiée doit faire référence à un élément à l'un des emplacements suivants :

  • Portée de nom XAML actuelle.
  • Portée de nom XAML du parent basé sur un modèle si la cible de liaison est dans un modèle de données ou modèle de contrôle.
En raison de cette restriction, vous ne pouvez pas utiliser la propriété ElementName pour établir une liaison aux éléments qui ne sont pas créés à l'aide du code XAML. Pour établir une liaison aux éléments créés par programmation, utilisez la propriété Source à la place. Source, RelativeSource et ElementName s'excluent mutuellement dans une liaison. Si vous avez défini l'un de ces attributs, la définition de l'un des deux autres dans une liaison (via XAML ou via le code) lèvera une exception.

Exemples

L'exemple de code suivant montre comment établir une liaison bidirectionnelle entre un TextBox et un contrôle Slider. Pour la liste de codes complète, consultez le scénario 1 dans Exemple de liaison de données.


<Slider x:Name="slider1" Minimum="1" Maximum="100"/>
<TextBox Text="{Binding ElementName=slider1, Path=Value, Mode=TwoWay}"/>


Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Espace de noms

Windows.UI.Xaml.Data
Windows::UI::Xaml::Data [C++]

Métadonnées

Windows.winmd

Voir aussi

Binding
Exemple de liaison de données
Liaison de données avec XAML

 

 

Afficher:
© 2017 Microsoft