Repeater (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 posee una representación integrada 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 repite la secuencia de 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 muchos 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 Cuadro de herramientas a la página.

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

Para enlazar el control Repeater a un origen de datos

1. En la Vista de 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 DropDownList, 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, vea 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 abrir 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 obtener ejemplos de definiciones de plantillas, vea el artículo Cómo: Agregar controles Repeater de servidor web a una página de formularios Web Forms  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. Por lo general, esta plantilla se usa para crear una apariencia diferente para elementos alternos, como 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 , vea el artículo Información general sobre Repeater (Control de servidor Web)  en MSDN Library.

Vea también

Conceptos

Trabajar con sitios ASP.NET
DataList (control)
DetailsView (control)
FormView (control)
GridView (control)

Copyright © 2011 de Microsoft Corporation. Reservados todos los derechos.