Introduction au contrôle DataRepeater (Visual Studio)

Article
09/04/2008

Mise à jour : Juillet 2008

Le contrôle DataRepeater Visual Basic Power Packs est un conteneur à défilement destiné aux contrôles qui affichent des données répétées, telles que des lignes dans une table de base de données. Il peut être utilisé en guise d'alternative au contrôle DataGridView lorsque vous avez besoin d'un plus grand contrôle sur la disposition des données. Le DataRepeater "répète" un groupe de contrôles connexes en créant plusieurs instances dans une vue de défilement. Vous pouvez ainsi visualiser simultanément plusieurs enregistrements.

Vue d'ensemble

Au moment du design, le contrôle DataRepeater comprend deux sections. La section externe correspond à la fenêtre d'affichage, dans laquelle les données de défilement seront affichées au moment de l'exécution. La section interne (supérieur), appelée modèle d'élément, est l'endroit où vous positionnez des contrôles qui seront répétés au moment de l'exécution (en général, un contrôle pour chaque champ de la source de données). Les propriétés et les contrôles du modèle d'élément sont encapsulés dans la propriété ItemTemplate.

Au moment de l'exécution, le ItemTemplate est copié vers un objet DataRepeaterItem virtuel qui est utilisé pour afficher les données lorsque chaque enregistrement fait l'objet d'un défilement dans l'affichage. Vous pouvez personnaliser l'affichage d'enregistrements individuels dans l'événement DrawItem en mettant par exemple un champ en surbrillance en fonction de la valeur qu'il contient. Pour plus d'informations, consultez Comment : modifier l'apparence d'un contrôle DataRepeater (Visual Studio).

Le contrôle DataRepeater est le plus souvent utilisé pour afficher des données à partir d'une table de base de données ou d'une autre source de données liée. Outre les objets de données ADO.NET, le contrôle DataRepeater peut créer une liaison avec toute classe qui implémente l'interface IList (y compris les tableaux), IListSource, IBindingList ou IBindingListView.

Liaison de données

En général, la liaison des données est effectuée en faisant glisser des champs de la fenêtre Sources de données sur le contrôle DataRepeater control. Pour plus d'informations, consultez Comment : afficher des données liées dans un contrôle DataRepeater (Visual Studio).

Lorsque vous travaillez avec d'importantes quantités de données, vous pouvez affecter la valeur True à la propriété VirtualMode pour afficher un sous-ensemble des données disponibles. Le mode virtuel requiert l'implémentation d'un cache de données à partir duquel le DataRepeater est rempli. Vous devez contrôler toutes les interactions avec le cache de données au moment de l'exécution. Pour plus d'informations, consultez Mode virtuel dans le contrôle DataRepeater (Visual Studio).

Vous pouvez également afficher des contrôles indépendants sur un contrôle DataRepeater. Par exemple, vous pouvez afficher une image répétée sur chaque élément. Pour plus d'informations, consultez Comment : afficher des données indépendantes dans un contrôle DataRepeater (Visual Studio).

Événements

Les événements les plus importants pour le contrôle DataRepeater sont l'événement DrawItem, qui est déclenché lorsque de nouveaux éléments font l'objet d'un défilement dans l'affichage, et l'événement CurrentItemIndexChanged, qui est déclenché lorsqu'un élément est sélectionné. Vous pouvez utiliser l'événement DrawItem pour changer l'apparence de l'élément. Vous pouvez par exemple mettre en surbrillance les valeurs négatives. Utilisez l'événement CurrentItemIndexChanged pour accéder aux valeurs des contrôles lorsqu'un élément est sélectionné.

Le contrôle DataRepeater expose tous les événements de contrôle standard dans l'Éditeur de code. Certains événements ne doivent cependant pas être utilisés. Les événements de clavier et de souris tels que KeyDown, Click et MouseDown ne sont pas déclenchés au moment de l'exécution car le contrôle DataRepeater n'a jamais le focus.

Le DataRepeaterItem n'expose pas d'événements au moment du design dans la mesure où il est seulement créé au moment de l'exécution. Si vous souhaitez gérer des événements de clavier et de souris, vous pouvez ajouter un contrôle Panel au ItemTemplate au moment du design, puis gérer les événements pour le Panel. Pour plus d'informations, consultez Dépannage des problèmes liés au contrôle DataRepeater (Visual Studio).

Personnalisations

Il existe de nombreuses façons de personnaliser l'apparence et du comportement du contrôle DataRepeater, tant au moment de l'exécution que du design. Des propriétés peuvent être configurées pour modifier les couleurs, masquer ou modifier les en-têtes d'élément, passer de l'orientation verticale à l'horizontale, etc. Pour plus d'informations, consultez Comment : modifier l'apparence d'un contrôle DataRepeater (Visual Studio), Comment : afficher des en-têtes d'élément dans un contrôle DataRepeater (Visual Studio) et Comment : modifier la disposition d'un contrôle DataRepeater (Visual Studio).

Notez que certaines propriétés s'appliquent au contrôle DataRepeater lui-même tandis que d'autres s'appliquent uniquement au ItemTemplate. Prenez soin de sélectionner la section correcte du contrôle avant de définir des propriétés. Pour plus d'informations, consultez Comment : modifier l'apparence d'un contrôle DataRepeater (Visual Studio).

D'autres personnalisations permettent de contrôler la capacité d'ajout ou de suppression d'enregistrements, d'ajouter des fonctions de recherche et d'afficher des données connexes dans un format maître/détail. Pour plus d'informations, consultez Comment : désactiver l'ajout et la suppression d'éléments dans un contrôle DataRepeater (Visual Studio), Comment : rechercher des données dans un contrôle DataRepeater (Visual Studio) et Comment : créer un formulaire maître/détail en utilisant deux contrôles DataRepeater (Visual Studio).