Repeater (control)

El control Repeater es un control contenedor que permite crear listas personalizadas a partir de los datos disponibles para la página. El control Repeater no incorpora representación propia, lo que significa que deberá proporcionar el diseño del control Repeater mediante la creación de plantillas. Cuando se ejecuta la página, el control Repeater recorre cada uno de los registros del origen de datos y representa un elemento para cada registro.

Dado que el control Repeater no dispone de una apariencia predeterminada, puede utilizarlo para crear varios tipos de listas, entre las que se incluyen las siguientes:

  • Diseño de tabla

  • Lista delimitada por comas (por ejemplo, a, b, c, d, etc.)

  • Lista con formato XML

Para agregar un control Repeater a una página

  • Arrastre el control Repeater del panel de tareas Cuadro de herramientas a la página.

Después de agregar un control Repeater, se puede especificar un origen de datos para el mismo.

Para enlazar el control Repeater a un origen de datos

  1. En la vista Diseño, haga clic con el botón secundario en el control Repeater y, a continuación, haga clic en Mostrar tareas de control comunes.

  2. En el menú Tareas de Repeater, haga clic en Elegir origen de datos.

  3. En el Asistente para la configuración de orígenes de datos, elija un origen para el control Repeater. Para obtener más información, consulte Configurar un origen de datos mediante un control enlazado a datos.

Para utilizar el control Repeater, cree plantillas que definan el diseño del contenido del control. Dichas plantillas pueden incluir cualquier combinación de marcado y controles. Si no se define ninguna plantilla o si ninguna de las plantillas contiene elementos, el control no aparecerá en la página cuando se ejecute la aplicación.

Para agregar y crear plantillas para el control Repeater

  1. En la vista Código, coloque el punto de inserción dentro de las etiquetas <asp:Repeater></asp:Repeater>.

  2. Presione la tecla menor que (<) para llamar a la lista desplegable de finalización de código.

  3. Haga clic en la plantilla que desea crear.

  4. Escriba el código HTML que desea para la plantilla. Para consultar un ejemplo de definición de plantillas, consulte el tema sobre cómo agregar de controles de servidor web Repeater a una página de formularios Web Forms (Visual Studio) (puede estar en inglés) en MSDN Library.

En la lista siguiente se describen las plantillas de Repeater compatibles con el control Repeater:

  • ItemTemplate Contiene los elementos HTML y los controles que se representan una vez por cada elemento del origen de datos.

  • AlternatingItemTemplate Contiene los elementos HTML y los controles que se representan una vez por cada dos elementos del origen de datos. Generalmente, esta plantilla sirve para crear una apariencia diferente para elementos alternos, como por ejemplo, un color de fondo distinto del especificado en ItemTemplate.

  • HeaderTemplate y FooterTemplate Contienen el texto y los controles que se representan al inicio y al final de la lista, respectivamente.

  • SeparatorTemplate Contiene los elementos que se representan entre cada elemento. Un ejemplo típico puede ser una línea (si se utiliza un elemento HR).

Para obtener más información acerca del uso del control Repeater, consulte la información general sobre el control de servidor web Repeater (puede estar en inglés) en MSDN Library.

Vea también

Conceptos

Introducción a ASP.NET

DataList (control)

DetailsView (control)

FormView (control)

GridView (control)