Binding.RelativeSource Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Property RelativeSource As RelativeSourceValor de propiedad
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.