Binding.RelativeSource Propriété

Définition

Obtient ou définit la source de liaison en spécifiant son emplacement par rapport à la position de la cible de liaison.Gets or sets the binding source by specifying its location relative to the position of the binding target.

public:
 property System::Windows::Data::RelativeSource ^ RelativeSource { System::Windows::Data::RelativeSource ^ get(); void set(System::Windows::Data::RelativeSource ^ value); };
public System.Windows.Data.RelativeSource RelativeSource { get; set; }
member this.RelativeSource : System.Windows.Data.RelativeSource with get, set
Public Property RelativeSource As RelativeSource

Valeur de propriété

RelativeSource

Objet RelativeSource spécifiant l’emplacement relatif de la source de liaison à utiliser.A RelativeSource object specifying the relative location of the binding source to use. La valeur par défaut est null.The default is null.

Exemples

L’exemple suivant montre un déclencheur de style qui crée un ToolTip qui signale un message d’erreur de validation.The following example shows a style trigger that creates a ToolTip that reports a validation error message. La valeur de l’accesseur Set est liée au contenu d’erreur du actuel TextBox ( TextBox à l’aide du style) à l’aide de la RelativeSource propriété.The value of the setter binds to the error content of the current TextBox (the TextBox using the style) using the RelativeSource property. Pour plus d’informations sur cet exemple, consultez Comment : implémenter la validation de liaison.For more information on this example, see How to: Implement Binding Validation.

<Style x:Key="textBoxInError" TargetType="{x:Type TextBox}">
  <Style.Triggers>
    <Trigger Property="Validation.HasError" Value="true">
      <Setter Property="ToolTip"
        Value="{Binding RelativeSource={x:Static RelativeSource.Self},
                        Path=(Validation.Errors)/ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Pour voir l’exemple complet, consultez exemple de validationde la liaison.To see the full example, see Binding Validation Sample.

Remarques

Cette propriété est couramment utilisée pour lier une propriété d’un objet à une autre propriété du même objet, ou pour définir une liaison dans un style ou un modèle.This property is commonly used to bind one property of an object to another property of the same object, or to define a binding in a style or template.

Par défaut, les liaisons héritent du contexte de données spécifié par la DataContext 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 RelativeSource 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 RelativeSource 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, consultez Comment : spécifier la source de liaison.For more information, see How to: Specify the Binding Source.

Les Binding.ElementName Binding.Source Propriétés et vous permettent également de définir explicitement la source de la liaison.The Binding.ElementName and Binding.Source properties also enable you to set the source of the binding explicitly. Toutefois, une seule des trois propriétés, ElementName , Source et 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 can 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.

Pour obtenir des informations sur XAML, consultez RelativeSource MarkupExtension.For XAML information, see RelativeSource MarkupExtension.

S’applique à

Voir aussi