Binding.RelativeSource Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Data
Assembly:
PresentationFramework.dll

Ruft die Bindungsquelle ab, indem deren Speicherort relativ zur Position des Bindungsziels angegeben wird, oder legt diese fest.

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. Der Standardwert ist null.

Beispiele

Im folgenden Beispiel wird ein Formatauslöser veranschaulicht, der eine Überprüfungsfehlermeldung meldet ToolTip . Der Wert des Setters bindet an den Fehlerinhalt des aktuellen TextBox (mithilfe TextBox der Formatvorlage) mithilfe der RelativeSource Eigenschaft. 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>

Informationen zum vollständigen Beispiel finden Sie im Beispiel für die Bindungsüberprüfung.

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 Möglichkeiten, wie Sie explizit die Quelle eines Binding und außer Kraft setzen können, um den geerbten Datenkontext zu überschreiben. Weitere Informationen finden Sie unter How to: Specify the Binding Source.

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

Informationen zu XAML finden Sie unter RelativeSource MarkupExtension.

Gilt für

Siehe auch