Binding.RelativeSource Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Data
Assembly:
PresentationFramework.dll

Obtient ou définit la source de liaison en spécifiant son emplacement par rapport à la position de la cible de liaison.

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. La valeur par défaut est null.

Exemples

L’exemple suivant montre un déclencheur de style qui crée un ToolTip message d’erreur de validation. La valeur du setter est liée au contenu d’erreur de l’élément actif TextBox (à TextBox l’aide du style) à l’aide de la RelativeSource propriété. Pour plus d’informations sur cet exemple, consultez Guide pratique pour implémenter la validation de liaison.

<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 l’exemple de validation de liaison.

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.

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 RelativeSource 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 propriétés et Binding.Source les Binding.ElementName propriétés 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 en cas de conflit de source de liaison.

Pour plus d’informations XAML, consultez RelativeSource MarkupExtension.

S’applique à

Voir aussi