Introducción al control DataRepeater (Visual Studio)

Artículo
02/19/2013

El control Visual Basic Power Packs DataRepeater es un contenedor desplazable para los controles que muestran datos repetidos, por ejemplo, las filas de una tabla de base de datos.Se puede usar como alternativa al control DataGridView cuando se necesita mayor control sobre el diseño de los datos.DataRepeater "repite" un grupo de controles relacionados creando varias instancias en una vista de desplazamiento.Esto permite a los usuarios ver varios registros al mismo tiempo.

Información general

En tiempo de diseño, el control DataRepeater está compuesto de dos secciones.La sección exterior es el ventanilla, donde se mostrarán los datos del desplazamiento en tiempo de ejecución.La sección interna (parte superior), conocida como plantilla de elementos, es donde se colocan los controles que se repetirán en tiempo de ejecución, normalmente, un control para cada campo del origen de datos.Las propiedades y controles de la plantilla de elementos se encapsulan en la propiedad ItemTemplate.

En tiempo de ejecución, ItemTemplate se copia en un objeto DataRepeaterItem virtual que se utiliza para mostrar datos cuando se desplaza cada registro en la vista.Puede personalizar la presentación de registros individuales en el evento DrawItem, por ejemplo, resaltando un campo basado en el valor que contiene.Para obtener más información, vea Cómo: Cambiar la apariencia de un control DataRepeater (Visual Studio).

El uso más común para un control DataRepeater es mostrar los datos de una tabla de base de datos u otro origen de datos enlazado.Además de objetos de datos ADO.NET, el control DataRepeater puede enlazarse a cualquier clase que implemente la interfaz IList (incluidas matrices), cualquier clase que implemente la interfaz IListSource, cualquier clase que implemente la interfaz IBindingList o cualquier clase que implemente la interfaz IBindingListView.

Enlace de datos

En general, el enlace de datos se realiza arrastrando campos de la ventana Orígenes de datos al control DataRepeater.Para obtener más información, vea Cómo: Mostrar los datos enlazados en un control DataRepeater (Visual Studio).

Al trabajar con grandes cantidades de datos, puede establecer la propiedad VirtualMode en True para mostrar un subconjunto de los datos disponibles.El modo virtual requiere la implementación de una caché de datos de la que se rellena DataRepeater y debe controlar todas las interacciones con la caché de datos en tiempo de ejecución.Para obtener más información, vea Modo virtual del control DataRepeater (Visual Studio).

También puede mostrar controles independientes en un control DataRepeater.Por ejemplo, puede mostrar una imagen que se repite en cada elemento.Para obtener más información, vea Cómo: Mostrar los datos no enlazados en un control DataRepeater (Visual Studio).

Eventos

Los eventos más importantes para el control DataRepeater son el evento DrawItem, que se provoca cuando se desplazan nuevos elementos en la vista, y el evento CurrentItemIndexChanged, que se provoca al seleccionar un elemento.Puede utilizar el evento DrawItem para cambiar la apariencia del elemento.Por ejemplo, puede resaltar los valores negativos.Utilice el evento CurrentItemIndexChanged para tener acceso a los valores de controles cuando hay un elemento seleccionado.

El control DataRepeater expone todos los eventos de control estándar en el Editor de código.Sin embargo, no se deben utilizar algunos de los eventos.Los eventos de teclado y mouse, como KeyDown, Click y MouseDown, no se provocarán en tiempo de ejecución porque el propio control DataRepeater nunca tiene el foco.

DataRepeaterItem no expone eventos en tiempo de diseño porque solo se crea en tiempo de ejecución.Si desea administrar eventos de teclado y mouse, puede agregar un control Panel a ItemTemplate en tiempo de diseño y, a continuación, administrar los eventos para Panel.Para obtener más información, vea Solución de problemas del control DataRepeater (Visual Studio).

Personalizaciones

Hay muchas maneras de personalizar la apariencia y el comportamiento del control DataRepeater, tanto en tiempo de ejecución como en tiempo de diseño.Se pueden establecer propiedades para cambiar colores, ocultar o modificar encabezados de elemento, cambiar la orientación de vertical a horizontal y mucho más.Para obtener más información, vea Cómo: Cambiar la apariencia de un control DataRepeater (Visual Studio), Cómo: Mostrar los encabezados de los elementos en un control DataRepeater (Visual Studio) y Cómo: Cambiar el diseño de un control DataRepeater (Visual Studio).

Observe que algunas propiedades se aplican al propio control DataRepeater mientras que otras solo se aplican a ItemTemplate.Asegúrese de que tiene seleccionada la sección del control correcta antes de establecer las propiedades.Para obtener más información, vea Cómo: Cambiar la apariencia de un control DataRepeater (Visual Studio).

Entre otras personalizaciones se incluyen controlar la capacidad de agregar o eliminar registros, agregar capacidades de búsqueda, y mostrar datos relacionados en un formato principal y de detalle.Para obtener más información, vea Cómo: Deshabilitar las operaciones de agregar y eliminar elementos DataRepeater (Visual Studio), Cómo: Buscar datos en un control DataRepeater (Visual Studio) y Cómo: Crear un formulario principal-detalle mediante dos controles DataRepeater (Visual Studio).