Binding.RelativeSource Eigenschaft

Definition

Namespace:

System.Windows.Data

Assembly:

PresentationFramework.dll

Ruft die Bindungsquelle ab oder legt sie fest, indem sie seine Position relativ zur Position des Bindungsziels angibt.

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

Eigenschaftswert

RelativeSource

Ein RelativeSource Objekt, das die relative Position der zu verwendenden Bindungsquelle angibt. Der Standardwert lautet null.

Beispiele

Das folgende Beispiel zeigt einen Formatauslöser, der eine ToolTip Fehlermeldung zur Überprüfung meldet. Der Wert des Setters wird mithilfe der Eigenschaft an den Fehlerinhalt des aktuellen TextBox ( TextBox mithilfe der Formatvorlage) RelativeSource gebunden. Weitere Informationen zu diesem Beispiel finden Sie unter 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>

Ein vollständiges Beispiel finden Sie unter Binding Validation Sample.

Hinweise

Diese Eigenschaft wird häufig verwendet, um eine Eigenschaft eines Objekts an eine andere Eigenschaft desselben Objekts zu binden oder eine Bindung in einer Formatvorlage oder Vorlage zu definieren.

Standardmäßig erben Bindungen den durch die DataContext Eigenschaft angegebenen Datenkontext, wenn eine festgelegt wurde. Die RelativeSource Eigenschaft ist jedoch eine der Methoden, mit denen Sie die Quelle eines Binding geerbten Datenkontexts explizit festlegen und außer Kraft setzen können. Weitere Informationen finden Sie unter How to: Specify the Binding Source.

Mit Binding.ElementName den Eigenschaften können Binding.Source Sie auch die Quelle der Bindung explizit festlegen. Für jede Bindung sollte jedoch nur eine der drei Eigenschaften festgelegt ElementNameSourceRelativeSourcewerden, oder ein Konflikt kann auftreten. Diese Eigenschaft löst eine Ausnahme aus, wenn ein Bindungsquellenkonflikt vorliegt.

Informationen zu XAML finden Sie unter RelativeSource MarkupExtension.

Weitere Informationen

• Source