Binding.RelativeSource Propiedad

Definición

Espacio de nombres:

System.Windows.Data

Ensamblado:

PresentationFramework.dll

Obtiene o establece el origen de enlace especificando su ubicación en relación con la posición del destino de enlace.

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

Valor de propiedad

RelativeSource

Objeto RelativeSource que especifica la ubicación relativa del origen de enlace que se usará. De manera predeterminada, es null.

Ejemplos

En el ejemplo siguiente se muestra un desencadenador de estilo que crea un ToolTip que notifica un mensaje de error de validación. El valor del establecedor se enlaza al contenido de error del actual TextBox (mediante TextBox el estilo ) mediante la RelativeSource propiedad . Para obtener más información sobre este ejemplo, vea 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>

Para ver el ejemplo completo, consulte Ejemplo de validación de enlaces.

Comentarios

Esta propiedad se usa normalmente para enlazar una propiedad de un objeto a otra propiedad del mismo objeto o para definir un enlace en un estilo o plantilla.

De forma predeterminada, los enlaces heredan el contexto de datos especificado por la DataContext propiedad , si se ha establecido uno. Sin embargo, la RelativeSource propiedad es una de las formas en que se puede establecer explícitamente el origen de Binding y invalidar el contexto de datos heredado. Para obtener más información, vea Cómo: Especificar el origen de enlace.

Las Binding.ElementName propiedades y Binding.Source también permiten establecer explícitamente el origen del enlace. Sin embargo, solo se debe establecer una de las tres propiedades, ElementName, Sourcey RelativeSource, para cada enlace o puede producirse un conflicto. Esta propiedad produce una excepción si hay un conflicto de origen de enlace.

Para obtener información de XAML, consulta RelativeSource MarkupExtension.

Consulte también

• Source