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

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. Die Standardeinstellung ist null.The default is null.

Beispiele

Das folgende Beispiel zeigt einen Stil--Fehler, ToolTip der eine erstellt, 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 TextBox RelativeSource -Eigenschaft an den Fehler Inhalt des TextBox aktuellen-Objekts (mit dem-Stil).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 BindungsValidierung.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 Binding explizit festlegen 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 Vorgehensweise: Geben Sie die BindungsQuelle an.For more information, see How to: Specify the Binding Source.

Die Binding.ElementName - Binding.Source Eigenschaft und die-Eigenschaft 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 ElementNamedrei SourceEigenschaften, RelativeSource, und 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:

Siehe auch