Binding.ElementName Propriété

Définition

Espace de noms:

System.Windows.Data

Assembly:

PresentationFramework.dll

Obtient ou définit le nom de l’élément à utiliser comme objet source de liaison.

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

public string ElementName { get; set; }

member this.ElementName : string with get, set

Public Property ElementName As String

Valeur de propriété

String

Valeur de la propriété Name ou de la directive x:Name de l’élément concerné. Vous ne pouvez faire référence à des éléments du code que s’ils sont inscrits dans le NameScope approprié via RegisterName. Pour plus d’informations, consultez Portées de nom XAML WPF.

La valeur par défaut est null.

Remarques

Cette propriété est utile lorsque vous souhaitez établir une liaison à la propriété d’un autre élément dans votre application. Par exemple, si vous souhaitez utiliser un Slider pour contrôler la hauteur d’un autre contrôle dans votre application ou si vous souhaitez lier le Content contrôle à la SelectedValue propriété de votre ListBox contrôle.

Par défaut, les liaisons héritent du contexte de données spécifié par la DataContext propriété, si une liaison a été définie. Toutefois, la ElementName propriété est l’une des façons dont vous pouvez définir explicitement la source d’un Binding contexte de données hérité et remplacer le contexte de données hérité. Pour plus d’informations, consultez Guide pratique pour spécifier la source de liaison.

Les Source propriétés et RelativeSource les propriétés de la Binding classe vous permettent également de définir explicitement la source de la liaison. Toutefois, une seule des trois propriétés, ElementNameet Source, et RelativeSource, doit être définie pour chaque liaison, ou un conflit peut se produire. Cette propriété lève une exception s’il existe un conflit de source de liaison.