RelativeSource-Klasse

Eine der Möglichkeiten zum Angeben einer Bindungsquelle besteht in der Verwendung der Binding.RelativeSource-Eigenschaft. Dies ist der Eigenschaftentyp dieser Eigenschaft. Die RelativeSource ist gleichzeitig eine Implementierung einer Markuperweiterung und ein Datenobjekt. Wenn die Erweiterung (siehe ProvideValue) sich selbst zurückgibt, sind die relevanten Informationen in den Daten enthalten. Der Hauptzweck der Markuperweiterung besteht darin, dass eine Konstruktorsyntax mit variablen Argumenten in Attributform verwendet werden kann. Dies ermöglicht die Inlinedefinition des FindAncestor-Modus mit zwei zusätzlichen Argumenten für den Typ und die Ebene des übergeordneten Elements, die für die anderen Modi nicht erforderlich sind.

Weitere Informationen zu XAML finden Sie unter RelativeSource-Markuperweiterung.

Das folgende Beispiel zeigt einen Formattrigger, mit dem ein ToolTip zur Anzeige einer Validierungsfehlermeldung erstellt wird. Mit der RelativeSource-Eigenschaft wird der Wert des Setters an den Fehlerinhalt der aktuellen TextBox (die TextBox, die das Format verwendet) gebunden. Weitere Informationen zu diesem Beispiel finden Sie unter Gewusst wie: Implementieren der Bindungsvalidierung.

<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)[0].ErrorContent}"/>
    </Trigger>
  </Style.Triggers>
</Style>

Im folgenden Beispiel wird die Style-Definition des benutzerdefinierten Steuerelements NumericUpDown veranschaulicht. Die Text-Eigenschaft von TextBlock ist an den Value des Objekts gebunden, das das TemplatedParent ist. Dabei handelt es sich um das NumericUpDown-Steuerelement, auf das dieser Style in diesem Fall angewendet wird.

<!--ControlTemplate for NumericUpDown that inherits from
    Control.-->
<Style TargetType="{x:Type local:NumericUpDown}">
  <Setter Property="HorizontalAlignment" Value="Center"/>
  <Setter Property="VerticalAlignment" Value="Center"/>
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="{x:Type local:NumericUpDown}">
        <Grid Margin="3">
          <Grid.RowDefinitions>
            <RowDefinition/>
            <RowDefinition/>
          </Grid.RowDefinitions>
          <Grid.ColumnDefinitions>
            <ColumnDefinition/>
            <ColumnDefinition/>
          </Grid.ColumnDefinitions>

          <Border BorderThickness="1" BorderBrush="Gray" 
                  Margin="2" Grid.RowSpan="2" 
                  VerticalAlignment="Center" HorizontalAlignment="Stretch">

            <TextBlock Text="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Value}" 
                       Width="60" TextAlignment="Right" Padding="5"/>
          </Border>

          <RepeatButton Command="{x:Static local:NumericUpDown.IncreaseCommand}"  
                        Grid.Column="1" Grid.Row="0">Up</RepeatButton>

          <RepeatButton Command="{x:Static local:NumericUpDown.DecreaseCommand}"
                        Grid.Column="1" Grid.Row="1">Down</RepeatButton>

        </Grid>

      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

Das vollständige Beispiel finden Sie unter NumericUpDown Custom Control with Theme and UI Automation Support Sample.

Im Folgenden wird das zweite ItemsControl auf dem Aufwärtspfad zurückgegeben, der mit dem Zielelement der Bindung beginnt.

		  Dim myBinding As New Binding()
		  ' Returns the second ItemsControl encountered on the upward path
		  ' starting at the target element of the binding
		  myBinding.RelativeSource = New RelativeSource(RelativeSourceMode.FindAncestor, GetType(ItemsControl), 2)

Binding myBinding = new Binding();
// Returns the second ItemsControl encountered on the upward path
// starting at the target element of the binding
myBinding.RelativeSource = new RelativeSource(
    RelativeSourceMode.FindAncestor, typeof(ItemsControl), 2);

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen