Binding.ElementName Binding.ElementName Binding.ElementName Binding.ElementName Property

Définition

Obtient ou définit le nom de l’élément à utiliser comme objet source de liaison.Gets or sets the name of the element to use as the binding source object.

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é

Valeur de la propriété Name ou de la directive x:Name de l’élément concerné.The value of the Name property or x:Name Directive of the element of interest. Vous ne pouvez faire référence à des éléments du code que s’ils sont inscrits dans le NameScope approprié via RegisterName.You can refer to elements in code only if they are registered to the appropriate NameScope through RegisterName. Pour plus d’informations, consultez Portées de nom XAML WPF.For more information, see WPF XAML Namescopes.

La valeur par défaut est null.The default is null.

Remarques

Cette propriété est utile lorsque vous souhaitez effectuer une liaison à la propriété d’un autre élément dans votre application.This property is useful when you want to bind to the property of another element in your application. Par exemple, si Slider vous souhaitez utiliser un pour contrôler la hauteur d’un autre contrôle dans votre application, ou si vous souhaitez lier le Content de votre contrôle à la SelectedValue propriété de votre ListBox contrôle.For example, if you want to use a Slider to control the height of another control in your application, or if you want to bind the Content of your control to the SelectedValue property of your ListBox control.

Par défaut, les liaisons héritent du contexte de données spécifié DataContext par la propriété, si celle-ci a été définie.By default, bindings inherit the data context specified by the DataContext property, if one has been set. Toutefois, la ElementName propriété est l’une des façons de définir explicitement la source d’un Binding et de substituer le contexte de données hérité.However, the ElementName property is one of the ways you can explicitly set the source of a Binding and override the inherited data context. Pour plus d'informations, voir Procédure : Spécifiez la sourcede liaison.For more information, see How to: Specify the Binding Source.

Les Source propriétés RelativeSource et de la Binding classe vous permettent également de définir explicitement la source de la liaison.The Source and RelativeSource properties of the Binding class also enable you to set the source of the binding explicitly. Toutefois, une seule des trois propriétés, ElementName, Sourceet RelativeSource, doit être définie pour chaque liaison, ou un conflit peut se produire.However, only one of the three properties, ElementName, Source, and RelativeSource, should be set for each binding, or a conflict might occur. Cette propriété lève une exception en cas de conflit de source de liaison.This property throws an exception if there is a binding source conflict.

S’applique à