Cómo: Especificar el origen de enlace

Actualización: noviembre 2007

En el enlace de datos, el objeto de origen de enlace hace referencia al objeto del que se obtienen los datos. En este tema se describen las distintas maneras de especificar el origen de enlace.

Ejemplo

Para enlazar varias propiedades a un mismo origen, utilice la propiedad DataContext, que proporciona una manera cómoda de establecer un ámbito dentro del cual todas las propiedades enlazadas a datos heredan un origen común.

En el ejemplo siguiente, el contexto de datos se establece en el elemento raíz de la aplicación. Esto permite que todos los elementos secundarios hereden ese contexto de datos. Los datos para el enlace proceden de una clase de datos personalizada, NetIncome, a la que se hace referencia directamente mediante una asignación que recibe la clave de recurso de incomeDataSource.

Para obtener el ejemplo de código completo, consulte Ejemplo Controlling the Direction and Timing of the Data Flow.

<Grid
  xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.DirectionalBinding"
  xmlns:c="clr-namespace:SDKSample"
  Name="Page1"
>
  <Grid.Resources>
    <c:NetIncome x:Key="incomeDataSource"/>
    <Style TargetType="{x:Type TextBlock}">
      <Setter Property="Padding" Value="8"/>
    </Style>
    <Style TargetType="{x:Type TextBox}">
      <Setter Property="Margin" Value="0,6,0,0"/>
    </Style>
  </Grid.Resources>
  <Grid.DataContext>
    <Binding Source="{StaticResource incomeDataSource}"/>
  </Grid.DataContext>


...


</Grid>

Nota

En el ejemplo anterior se crea una instancia del objeto en marcado y se utiliza como recurso. Si desea enlazar a un objeto del que ya se ha creado una instancia en el código, deberá establecer la propiedad DataContext mediante programación. Para obtener un ejemplo, consulte Cómo: Hacer que los datos estén disponibles para el enlace en XAML.

Como alternativa, si desea especificar explícitamente el origen en los enlaces individuales, dispone de las opciones siguientes. Éstas tienen prioridad sobre el contexto de datos heredado.

Propiedad

Descripción

Source

Esta propiedad se utiliza para establecer el origen en una instancia de un objeto. Si no necesita la funcionalidad de establecer un ámbito en el que varias propiedades hereden el mismo contexto de datos, puede utilizar la propiedad Source en lugar de la propiedad DataContext. Para obtener más información, consulte Source.

RelativeSource

Resulta útil si desea especificar el origen con relación a la ubicación donde se encuentra el destino de enlace. Algunos escenarios comunes donde puede utilizar esta propiedad son aquéllos en los que desea enlazar una propiedad del elemento a otra propiedad del mismo elemento o en los que se define un enlace en un estilo o una plantilla. Para obtener más información, consulte RelativeSource.

ElementName

Especifica una cadena que representa el elemento que se desea enlazar. Resulta útil si desear enlazar la propiedad de otro elemento de la aplicación. Por ejemplo, si desea utilizar un control Slider para controlar el alto de otro control de la aplicación, o si desea enlazar la propiedad Content del control a la propiedad SelectedValue del control ListBox. Para obtener más información, consulte ElementName.

Vea también

Tareas

Ejemplo Controlling the Direction and Timing of the Data Flow

Conceptos

Herencia de valores de propiedad

Información general sobre el enlace de datos

Información general sobre declaraciones de enlaces

Referencia

FrameworkElement.DataContext

FrameworkContentElement.DataContext

Otros recursos

Ejemplos de enlace de datos

Temas "Cómo..." sobre enlace de datos