ASP:TABLEROW

Syntaxe

Paramètres

Description

Cette balise permet de définir une ligne de tableau.

Remarques

• Le contrôle <asp:TableRow> représente une ligne dans un tableau ASP.NET construit avec <asp:Table>. Il s'agit d'un conteneur logique pour des cellules de type <asp:TableCell>, permettant d'organiser les données verticalement dans la structure tabulaire.
• Une <asp:TableRow> ne peut pas fonctionner seule : elle doit obligatoirement être utilisée au sein d'un <asp:Table>, autrement elle ne sera pas rendue correctement sur la page, et le comportement du code risque d'être imprévisible.
• La déclaration d'une balise <asp:TableRow> doit inclure l'attribut runat="server". Sans cela, ASP.NET ne pourra pas la traiter côté serveur, et elle ne pourra pas être manipulée dans le code-behind.
• Chaque ligne dans un tableau ASP.NET est créée à l'aide de la balise <asp:TableRow>, et contient généralement plusieurs <asp:TableCell> définissant les colonnes de la ligne. Cela reproduit fidèlement la structure des tableaux HTML.
• La classe TableRow dans ASP.NET est fortement intégrée à l'environnement serveur. Cela permet d'ajouter dynamiquement des lignes à un tableau, souvent en fonction de données extraites d'une base ou saisies par l'utilisateur.
• Le contrôle TableRow peut être stylisé indépendamment. On peut lui appliquer des propriétés comme BackColor, CssClass, Height, ou encore Font, ce qui permet de créer des effets visuels comme le zébrage des lignes.
• L'ajout de cellules dans une TableRow peut se faire via la collection Cells. Par exemple, en C# : maLigne.Cells.Add(new TableCell()); permet de remplir dynamiquement la ligne dans le code-behind.
• Une TableRow peut contenir tout type de contrôle WebForms dans ses cellules : des labels, des boutons, des zones de texte. Cela permet de créer des tableaux riches en interaction.
• Dans le cas d'un tableau généré dynamiquement, chaque TableRow peut représenter une entité métier ou un enregistrement de base de données. Cela permet de faire correspondre la structure UI à la logique métier.
• Pour organiser les en-têtes de tableau, on peut combiner une TableRow avec des cellules de type <asp:TableHeaderCell>, ce qui offre une meilleure sémantique HTML et une accessibilité améliorée.
• Il est possible de définir des propriétés comme HorizontalAlign ou VerticalAlign sur une TableRow afin de gérer l'alignement général de toutes les cellules de cette ligne. C'est utile pour un affichage cohérent.
• Une ligne de tableau (TableRow) peut être rendue conditionnellement invisible en jouant sur la propriété Visible. Cela permet d'implémenter des logiques d'affichage contextuelles sans supprimer la ligne du DOM.
• Lorsqu'une ligne est créée dynamiquement, il est important de lui assigner un identifiant (ID) si l'on souhaite y faire référence ultérieurement dans le cycle de vie de la page ASP.NET.
• Le cycle de vie du contrôle TableRow suit le même modèle que les autres contrôles serveur ASP.NET, avec des événements comme Init, Load, et PreRender, ce qui permet une gestion fine de son comportement.
• Une utilisation fréquente de TableRow est dans les tableaux administratifs où chaque ligne peut contenir des données et des actions comme "modifier", "supprimer", ou "voir les détails", en intégrant des boutons dans les cellules.

Exemple

Voici un exemple montrant comment afficher un tableau avec une bordure :

on obtiendra le résultat semblable suivant :

Voir également

Articles - Les géants de l'informatique - Microsoft