Vue d'ensemble des contrôles serveur Web, Table, TableRow et TableCell

Mise à jour : novembre 2007

Le contrôle serveur Web Table vous permet de créer des tables sur les pages ASP.NET que vous pouvez programmer dans le code serveur. Les contrôles serveur Web TableRow et TableCell vous offrent la possibilité d'afficher le contenu du contrôle Table.

Cette rubrique contient les sections suivantes :

• Contexte

• Exemples de code

• Référence de classe

Contexte

En général, les tables servent non seulement à présenter des informations tabulaires, mais aussi à mettre en forme des informations dans une page Web. Il existe plusieurs façons de créer des tables dans une page ASP.NET :

• Table HTML. Si vous créez une table statique (dans laquelle vous n'ajoutez pas ou ne modifiez pas le contenu au moment de l'exécution), vous devez utiliser une table HTML, et non un contrôle Table.

• Contrôle HtmlTable. Il s'agit d'un élément HTML table converti en contrôle serveur HTML par l'ajout de l'attribut runat=server. Vous pouvez programmer ce contrôle dans le code serveur. Pour plus d'informations sur les contrôles serveur HTML, consultez Vue d'ensemble des contrôles serveur Web ASP.NET.

• Table. Il s'agit d'un contrôle Web qui vous permet de créer et de manipuler des tables (par exemple, ajouter des lignes et des cellules de table) à l'aide d'un modèle d'objet compatible avec les autres contrôles Web.

En général, vous utilisez un contrôle serveur Web Table lorsque vous avez l'intention d'ajouter des lignes et des cellules (colonnes) à la table dans le code lors de l'exécution. Bien que vous puissiez l'utiliser en tant que table statique avec des lignes et des cellules prédéfinies, il est plus simple dans ce cas d'utiliser l'élément HTML table.

Le contrôle serveur Web Table est parfois plus facile à programmer que le contrôle HtmlTable dans la mesure où il offre un modèle d'objet avec des propriétés typées qui est compatible avec d'autres contrôles serveur Web. (Le modèle est également compatible avec les contrôles Table, TableRow et TableCell).

Comparaison du contrôle serveur Web Table à d'autres contrôles serveur Web de type Liste

Certaines fonctions que vous pouvez accomplir avec un contrôle serveur Web Table peuvent être effectuées également avec les contrôles serveur Web de liste, notamment les contrôles Repeater, DataList et GridView. Tous ces contrôles se présentent (ou peuvent se présenter) sous la forme de tables HTML.

Il existe des différences entre les contrôles de type Liste et le contrôle Table :

• Les contrôles de type Liste sont liés aux données. Ils ne peuvent être utilisés qu'avec une source de données tandis que le contrôle Table peut afficher toute combinaison de contrôles et texte HTML, qu'ils soient liés aux données ou non.

• Les contrôles de type Liste utilisent des modèles pour spécifier la disposition de leurs éléments. Le contrôle Table prend en charge le contrôle enfant TableCell, que vous pouvez remplir comme s'il s'agissait d'un quelconque élément HTML td.

Modèle d'objet du contrôle serveur Web Table

Le contrôle Table joue le rôle de contrôle parent des contrôles TableRow. La table prend en charge une propriété nommée Rows qui représente une collection d'objets TableRow. En ajoutant ou supprimant des éléments dans cette collection, vous spécifiez les lignes de la table. Le contrôle TableRow prend en charge ensuite une collection nommée Cells qui contient des objets TableCell.

Le contenu à afficher dans la table est ajouté au contrôle TableCell. La cellule possède une propriété Text que vous définissez en tant que texte HTML. Vous pouvez, par ailleurs, afficher des contrôles dans la cellule en ajoutant des contrôles à la collection de cellules Controls.

Le contrôle parent Table prend en charge des propriétés qui déterminent l'apparence de toute la table, telles que Font, BackColor et ForeColor. Les contrôles TableRow et TableCell prennent également en charge ces propriétés de sorte que vous pouvez définir l'apparence de lignes ou de cellules individuelles, qui se substitue alors à celle de la table parente.

Liaison de données au contrôle

Bien que le contrôle Table ne soit pas fondamentalement lié aux données, vous pouvez l'utiliser pour afficher des données d'une base de données. À l'instar de tous les contrôles serveur Web, vous pouvez lier n'importe quelle propriété d'un contrôle Table à une source de données. Néanmoins, le contrôle Table ne prend pas en charge une propriété que vous utilisez pour afficher directement des données. En réalité, vous ajoutez plutôt des contrôles TableCell à la table. Vous pouvez ensuite lier la propriété Text des contrôles TableCell individuels aux données, ou ajouter des contrôles liés aux données (comme un contrôle Label ou Literal) à la cellule.

Retour au début

Exemples de code

Comment : ajouter des contrôles serveur Web Table à une page Web Forms (Visual Studio)

Comment : ajouter des lignes et des cellules de façon dynamique à un contrôle serveur Web Table

Retour au début

Référence de classe

Le tableau suivant répertorie les classes relatives aux contrôles Table, TableCell et TableRow.

Retour au début

Voir aussi

Référence

HtmlTable

HtmlTableRow

HtmlTableCell