Binding.RelativeSource Property

Definition

Obtiene o establece el origen de enlace especificando su ubicación en relación con la posición del destino de enlace.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

Property Value

RelativeSource

Objeto RelativeSource que especifica la ubicación relativa del origen de enlace que se usará.A RelativeSource object specifying the relative location of the binding source to use. El valor predeterminado es null.The default is null.

Examples

En el ejemplo siguiente se muestra un desencadenador de estilo que crea un ToolTip que notifica un mensaje de error de validación.The following example shows a style trigger that creates a ToolTip that reports a validation error message. El valor del establecedor enlaza con el contenido de error del TextBox actual (el TextBox con el estilo) mediante la propiedad RelativeSource.The value of the setter binds to the error content of the current TextBox (the TextBox using the style) using the RelativeSource property. Para obtener más información sobre este ejemplo, consulte Cómo: implementar la validación de enlaces.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>

Para ver el ejemplo completo, vea enlace de ejemplo de validación.To see the full example, see Binding Validation Sample.

Remarks

Esta propiedad se utiliza normalmente para enlazar una propiedad de un objeto a otra propiedad del mismo objeto o para definir un enlace en un estilo o una plantilla.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.

De forma predeterminada, los enlaces heredan el contexto de datos especificado por la propiedad DataContext, si se ha establecido uno.By default, bindings inherit the data context specified by the DataContext property, if one has been set. Sin embargo, la propiedad RelativeSource es una de las formas en que se puede establecer explícitamente el origen de un Binding y reemplazar el contexto de datos heredado.However, the RelativeSource property is one of the ways you can explicitly set the source of a Binding and override the inherited data context. Para obtener más información, vea Cómo: especificar el origen de enlace.For more information, see How to: Specify the Binding Source.

Las propiedades Binding.ElementName y Binding.Source también permiten establecer el origen del enlace explícitamente.The Binding.ElementName and Binding.Source properties also enable you to set the source of the binding explicitly. Sin embargo, solo se debe establecer una de las tres propiedades, ElementName, Sourcey RelativeSource, para cada enlace, o puede producirse un conflicto.However, only one of the three properties, ElementName, Source, and RelativeSource, should be set for each binding, or a conflict can occur. Esta propiedad produce una excepción si hay un conflicto de origen de enlace.This property throws an exception if there is a binding source conflict.

Para obtener XAMLXAML información, vea la MarkupExtension de RelativeSource.For XAMLXAML information, see RelativeSource MarkupExtension.

Applies to

See also