Binding.RelativeSource Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.