Binding.RelativeSource Właściwość

Definicja

Pobiera lub ustawia źródło powiązania, określając jego lokalizację względem położenia obiektu docelowego powiązania.

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

RelativeSource Obiekt określający względną lokalizację źródła powiązania do użycia. Wartość domyślna to null.

Przykłady

W poniższym przykładzie przedstawiono wyzwalacz stylu, który tworzy ToolTip komunikat o błędzie weryfikacji. Wartość elementu setter wiąże się z zawartością błędu bieżącego TextBox ( TextBox przy użyciu stylu) przy użyciu RelativeSource właściwości . Aby uzyskać więcej informacji na temat tego przykładu, zobacz Instrukcje: implementowanie weryfikacji powiązań.

<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 wyświetlić pełny przykład, zobacz Przykład weryfikacji powiązań.

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.

Domyślnie powiązania dziedziczą kontekst danych określony przez DataContext właściwość, jeśli został ustawiony. RelativeSource Jednak właściwość jest jednym ze sposobów jawnego ustawienia źródła Binding i zastąpienia dziedziczonego kontekstu danych. Aby uzyskać więcej informacji, zobacz Instrukcje: określanie źródła powiązania.

Właściwości Binding.ElementName i Binding.Source umożliwiają również jawne ustawienie źródła powiązania. Jednak tylko jedna z trzech właściwości, ElementName, Sourcei RelativeSource, powinna być ustawiona dla każdego powiązania lub może wystąpić konflikt. Ta właściwość zgłasza wyjątek, jeśli występuje konflikt powiązania źródła.

Aby uzyskać informacje o języku XAML, zobacz RelativeSource MarkupExtension.

Dotyczy

Zobacz też