Partager via


Repeater, contrôle

Le contrôle Repeater est un contrôle conteneur qui permet de créer des listes personnalisées à partir des données disponibles pour la page. Le contrôle Repeater n’a pas de rendu intégré propre, ce qui signifie que vous devez fournir la disposition du contrôle Repeater en créant des modèles. Lors de l’exécution de la page, le contrôle Repeater parcourt les enregistrements figurant dans la source de données et assure le rendu d’un élément pour chaque enregistrement.

Le contrôle Repeater n’ayant aucune apparence par défaut, vous pouvez l’utiliser pour créer de nombreux types de listes, notamment les suivants :

  • Disposition en tableau

  • Liste délimitée par des virgules (par exemple, a, b, c, d, etc.)

  • Liste XML mise en forme

Pour ajouter un contrôle Repeater à une page

  • Faites glisser le contrôle Repeater du volet des tâches Boîte à outils sur votre page.

Après avoir ajouté un contrôle Repeater, vous pouvez spécifier une source de données pour le contrôle.

Pour lier le contrôle Repeater à une source de données

  1. En mode Création, cliquez avec le bouton droit sur le contrôle Repeater, puis cliquez sur Afficher les tâches de contrôle courantes.

  2. Dans le menu Tâches courantes du contrôle DropDownList, cliquez sur Choisir une source de données.

  3. Dans l’Assistant Configuration de source de données, choisissez une source pour le contrôle Repeater. Pour plus d’informations, voir Configurer une source de données à l’aide d’un contrôle lié aux données.

Pour utiliser le contrôle Repeater, vous devez créer des modèles qui définissent la disposition du contenu du contrôle. Les modèles peuvent contenir n’importe quelle combinaison de balisage et de contrôles. Si aucun modèle n’est défini ou si aucun des modèles ne comprend d’éléments, le contrôle n’apparaît pas dans la page lorsque l’application est exécutée.

Pour créer des modèles pour le contrôle Repeater

  1. En mode Code, placez le point d’insertion à l’intérieur des balises <asp:Repeater></asp:Repeater>.

  2. Appuyez sur la touche inférieur à (<) pour afficher la liste déroulante d’aide à la saisie du code

  3. Cliquez sur le modèle que vous voulez créer.

  4. Entrez le code HTML que vous voulez pour le modèle. Pour obtenir un exemple de définitions de modèles, voir Comment : Ajouter des contrôles serveur Web Repeater à une page Web Forms (Visual Studio) dans MSDN Library.

Le tableau suivant décrit les modèles Repeater pris en charge par le contrôle Repeater.

  • ItemTemplate Contient les éléments et les contrôles HTML à rendre une fois pour chaque élément de données de la source de données.

  • AlternatingItemTemplate Contient les éléments et les contrôles HTML à rendre une fois pour un élément de données sur deux dans la source de données. En général, ce modèle sert à donner une apparence différente aux éléments en alternance, par exemple une couleur d’arrière-plan autre que celle qui est spécifiée dans la propriété ItemTemplate.

  • HeaderTemplate and FooterTemplate Contient le texte et les contrôles à rendre en début et en fin de liste, respectivement.

  • SeparatorTemplate Contient les éléments à rendre entre chaque élément. Une ligne (utilisant un élément HR) en est un exemple.

Pour plus d’informations sur l’utilisation du contrôle Repeater, voir Vue d’ensemble du contrôle serveur Web Repeater dans MSDN Library.

Voir aussi

Concepts

Vue d’ensemble d’ASP.NET

DataList, contrôle

DetailsView, contrôle

FormView, contrôle

GridView, contrôle