Binding.RelativeSource Właściwość

Definicja

Pobiera lub ustawia źródło powiązania, określając jego lokalizację względem pozycji docelowej powiązania.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

Wartość właściwości

RelativeSource

RelativeSourceObiekt określający względną lokalizację źródła powiązania do użycia.A RelativeSource object specifying the relative location of the binding source to use. Wartość domyślna to null.The default is null.

Przykłady

Poniższy przykład pokazuje wyzwalacz stylu, który tworzy ToolTip raport, który wyświetla komunikat o błędzie walidacji.The following example shows a style trigger that creates a ToolTip that reports a validation error message. Wartość metody ustawiającej wiąże się z zawartością błędu bieżącego TextBox ( TextBox przy użyciu stylu) przy użyciu RelativeSource właściwości.The value of the setter binds to the error content of the current TextBox (the TextBox using the style) using the RelativeSource property. Aby uzyskać więcej informacji na temat tego przykładu, zobacz How to: Implementuj sprawdzanie poprawności powiązań.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>

Aby zapoznać się z pełnym przykładem, zobacz przykładowe sprawdzanie poprawności powiązań.To see the full example, see Binding Validation Sample.

Uwagi

Ta właściwość jest często używana do powiązania jednej właściwości obiektu z inną właściwością tego samego obiektu lub do definiowania powiązania w stylu lub szablonie.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.

Domyślnie powiązania dziedziczą kontekst danych określony przez DataContext Właściwość, jeśli został on ustawiony.By default, bindings inherit the data context specified by the DataContext property, if one has been set. RelativeSourceWłaściwość jest jednak jednym ze sposobów, w której można jawnie ustawić źródło Binding i zastąpić Dziedziczony kontekst danych.However, the RelativeSource property is one of the ways you can explicitly set the source of a Binding and override the inherited data context. Aby uzyskać więcej informacji, zobacz How to: Określanie źródła powiązania.For more information, see How to: Specify the Binding Source.

Binding.ElementNameWłaściwości i Binding.Source umożliwiają również jawne ustawienie źródła powiązania.The Binding.ElementName and Binding.Source properties also enable you to set the source of the binding explicitly. Jednak dla każdego powiązania należy określić tylko jedną z trzech właściwości, ElementName , Source , i RelativeSource , lub może wystąpić konflikt.However, only one of the three properties, ElementName, Source, and RelativeSource, should be set for each binding, or a conflict can occur. Ta właściwość zgłasza wyjątek, jeśli występuje konflikt źródła powiązania.This property throws an exception if there is a binding source conflict.

Aby uzyskać informacje na temat języka XAML, zobacz RelativeSource MarkupExtension.For XAML information, see RelativeSource MarkupExtension.

Dotyczy

Zobacz też