Enlace de datos en un cliente de Windows Presentation Foundation

El ejemplo de WPFDataBinding muestra el uso de enlace de datos en un cliente Windows Presentation Foundation (WPF). El ejemplo usa un servicio Windows Communication Foundation (WCF) que genera de forma aleatoria una matriz de álbumes para devolver al cliente. Cada álbum tiene un nombre, un precio y una lista de pistas. Las pistas del álbum tienen un nombre y duración. La información que devuelve el servicio se enlaza de forma automática a la interfaz de usuario (UI) que proporciona el cliente Windows Presentation Foundation (WPF).

Nota

El procedimiento de instalación y las instrucciones de compilación de este ejemplo se encuentran al final de este tema.

El enlace de datos permite enlazar un origen de datos automáticamente a una Interfaz de usuario. Esto simplifica el modelo de programación porque no requiere que usted actualice mediante programación cada elemento de la interfaz de usuario con los datos de un objeto de datos o una matriz de objetos de datos. Puede enlazar un objeto a un elemento de la interfaz de usuario único o una matriz a un control que toma varias entradas, como un ListBox. El código siguiente muestra cómo enlazar los datos a DataContext de un elemento de la interfaz de usuario.

// Event handler executed when call is complete
void client_GetAlbumListCompleted(object sender, GetAlbumListCompletedEventArgs e)
{
    // This is on the UI thread, myPanel can be accessed directly
    myPanel.DataContext = e.Result;
}

En el ejemplo anterior, DataContext para el elemento de diseño grid denominado myPanel está establecido en los datos devueltos por el método GetAlbumList. DataContext permite a los elementos heredar información de sus elementos principales sobre el origen de datos que se utiliza para enlazar, así como otras características del enlace como la ruta de acceso. La línea de código se debe ejecutar cada vez que se actualizan los datos en el servidor. Por ejemplo, se ejecuta cuando se inicializa la ventana y cuando se agrega un nuevo álbum.

En el ejemplo siguiente de código XAML, ListBox especifica ItemsSource="{Binding }".

<ListBox
          ItemTemplate="{StaticResource AlbumStyle}"
          ItemsSource="{Binding }"
          IsSynchronizedWithCurrentItem="true" />

Esto especifica que los datos enlazados al elemento de la interfaz de usuario de nivel superior también está enlazado a este control (es decir, la matriz de Álbumes). Además, ItemTemplate="{StaticResource AlbumStyle}" especifica la plantilla de datos que se va a utilizar para cada elemento en ListBox. También puede definir las plantillas de datos para especificar cómo se debería dar formato a los datos. Estas plantillas de datos se pueden reutilizar para otros elementos de la interfaz de usuario en la aplicación, la ventaja es que la plantilla de datos se define y mantiene en un lugar.

La plantilla de datos AlbumStyle pone en paralelo una cuadrícula con dos TextBlocks. Uno especifica el nombre del Álbum y el otro el número de Pistas en el álbum.

<DataTemplate x:Key="AlbumStyle">
    <Grid>
        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="260" />
            <ColumnDefinition Width="60" />
        </Grid.ColumnDefinitions>
        <TextBlock Grid.Column="0" TextContent="{Binding Path=Title}" />
        <TextBlock Grid.Column="1" TextContent="{Binding Path=Tracks#.Count}" HorizontalAlignment="Right" />
    </Grid>
</DataTemplate>

El siguiente código XAML crea un segundoListBox.

<ListBox Grid.Row="2"
            Grid.ColumnSpan="2"
            ItemTemplate="{StaticResource TrackStyle}"
            ItemsSource="{Binding Path=Tracks}" />

El código especifica una ruta de acceso para ItemsSource. Esto indica que el límite de los datos enlazados con este control no son los datos de nivel superior sino una propiedad de los datos de nivel superior denominada Tracks. Esta propiedad representa la matriz de pistas contenida dentro del álbum. Además, se especifica un DataTemplate diferente denominadoTrackStyle . El diseño de la plantilla TrackStyle es similar al de la plantilla AlbumStyle, pero TextBlocks se enlazan a diferentes propiedades. Esto es porque las dos plantillas se utilizan con objetos de datos diferentes.

Configurar, compilar y ejecutar el ejemplo

1. Asegúrese de que ha realizado el procedimiento de instalación única para los ejemplos de Windows Communication Foundation.

2. Para compilar el código C# o Visual Basic .NET Edition de la solución, siga las instrucciones de Building the Windows Communication Foundation Samples.

3. Para ejecutar el ejemplo en una configuración de una sola máquina o de varias máquinas, siga las instrucciones que se indican en Ejecución de los ejemplos de Windows Communication Foundation.