Binding.RelativeSource Eigenschaft

Definition

Ruft die Bindungsquelle ab, indem deren Speicherort relativ zur Position des Bindungsziels angegeben wird, oder legt diese fest.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

Eigenschaftswert

RelativeSource

Ein RelativeSource-Objekt, das den relativen Speicherort der zu verwendenden Bindungsquelle angibt.A RelativeSource object specifying the relative location of the binding source to use. Der Standardwert ist null.The default is null.

Beispiele

Das folgende Beispiel zeigt einen Stil--Fehler, der eine erstellt ToolTip , die eine Validierungs Fehlermeldung meldet.The following example shows a style trigger that creates a ToolTip that reports a validation error message. Der Wert des Setters bindet mithilfe der-Eigenschaft an den Fehler Inhalt des aktuellen- TextBox TextBox Objekts (mit dem-Stil) RelativeSource .The value of the setter binds to the error content of the current TextBox (the TextBox using the style) using the RelativeSource property. Weitere Informationen zu diesem Beispiel finden Sie unter Gewusst wie: Implementieren der Bindungs Validierung.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>

Das vollständige Beispiel finden Sie unter Beispiel für Bindungs Validierung.To see the full example, see Binding Validation Sample.

Hinweise

Diese Eigenschaft wird häufig verwendet, um eine Eigenschaft eines Objekts an eine andere Eigenschaft desselben Objekts zu binden oder um eine Bindung in einem Stil oder einer Vorlage zu definieren.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.

Standardmäßig erben Bindungen den Datenkontext, der von der- DataContext Eigenschaft angegeben wird, sofern ein solcher festgelegt wurde.By default, bindings inherit the data context specified by the DataContext property, if one has been set. Die RelativeSource -Eigenschaft ist jedoch eine der Methoden, mit denen Sie die Quelle einer explizit festlegen Binding und den geerbten Datenkontext überschreiben können.However, the RelativeSource property is one of the ways you can explicitly set the source of a Binding and override the inherited data context. Weitere Informationen finden Sie unter Gewusst wie: Angeben der Bindungs Quelle.For more information, see How to: Specify the Binding Source.

Die Binding.ElementName -Eigenschaft und die-Eigenschaft Binding.Source ermöglichen es Ihnen außerdem, die Quelle der Bindung explizit festzulegen.The Binding.ElementName and Binding.Source properties also enable you to set the source of the binding explicitly. Allerdings sollte für jede Bindung nur eine der drei Eigenschaften,, ElementName Source und RelativeSource festgelegt werden, oder es kann ein Konflikt auftreten.However, only one of the three properties, ElementName, Source, and RelativeSource, should be set for each binding, or a conflict can occur. Diese Eigenschaft löst eine Ausnahme aus, wenn ein Bindungs Quellen Konflikt vorliegt.This property throws an exception if there is a binding source conflict.

Weitere XAMLXAML Informationen finden Sie unter RelativeSource MarkupExtension.For XAMLXAML information, see RelativeSource MarkupExtension.

Gilt für:

Weitere Informationen