ASP:TABLE |
ASP : Tableau |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:Table paramètres> ... </asp:Table> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| AccessKey=valeur | Ce paramètre de balise permet d'indiquer un touche de raccourci à associer avec cette balise. | ||
| BackColor=valeur | Ce paramètre permet d'indiquer la couleur d'arrière plan de la balise. | ||
| Border=valeur | Ce paramètre de balise permet de définir la largeur en pixel d'une bordure de tableau. | ||
| BorderColor=valeur | Ce paramètre permet d'indiquer la couleur de bordure de la balise. | ||
| BorderStyle=valeur | Ce paramètre permet d'indiquer le style de bordure de la balise : NotSet, None, Dotted, Dashed, Solid, Double, Groove, Ridge, Inset ou Outset. | ||
| BorderWidth=valeur | Ce paramètre permet d'indiquer la largeur de la bordure de la balise. | ||
| CssClass=valeur | Ce paramètre permet d'indiquer la classe de feuille de style CSS de la balise. | ||
| Caption=valeur | Ce paramètre permet d'indiquer le titre du tableau. | ||
| CaptionAlign=valeur | Ce paramètre permet d'indiquer l'alignement du tableau : | ||
| Constante | Description | ||
| "Bottom" | Cette constante permet d'indiquer que le tableau est aligné vers le bas. | ||
| "Left" | Cette constante permet d'indiquer que le tableau est aligné vers la gauche. | ||
| "Right" | Cette constante permet d'indiquer que le tableau est aligné vers la droite. | ||
| "Top" | Cette constante permet d'indiquer que le tableau est aligné vers le haut. | ||
| CellPadding=valeur | Ce paramètre de balise permet de définir l'espace entre les cellules et le contenu du tableau. | ||
| CellSpacing=valeur | Ce paramètre de balise permet de définir l'espace entre les cellules du tableau. | ||
| Enabled=valeur | Ce paramètre permet d'indiquer si la balise doit être active ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| "True" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| EnableTheming=valeur | Ce paramètre permet d'indiquer si le thème de la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le thème de la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que le thème de la balise est affiché. | ||
| EnableViewState=valeur | Ce paramètre permet d'indiquer si le ViewState de la balise doit être activé ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le ViewState de la balise n'est pas actif. | ||
| "True" | Cette constante permet d'indiquer que le ViewState de la balise est actif. | ||
| Font-Bold=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être en gras ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas en gras. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est en gras. | ||
| Font-Italic=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être en italique ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas en italique. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est en italique. | ||
| Font-Names=valeur | Ce paramètre permet d'indiquer les noms de la police de caractères. | ||
| Font-Overline=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être surligné ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas surligné. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est surligné. | ||
| Font-Size=valeur | Ce paramètre permet d'indiquer la taille de la police de caractères de la balise : Smaller, Larger, XX-Small, X-Small, Small, Medium, Large, X-Large ou XX-Large. | ||
| Font-Strikeout=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être barré ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas barré. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est barré. | ||
| Font-Underline=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être souligné ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas souligné. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est souligné. | ||
| ForeColor=valeur | Ce paramètre permet d'indiquer la couleur de premier plan de la balise. | ||
| GridLines=valeur | Ce paramètre permet d'indiquer le style de ligne de grille : | ||
| Constante | Description | ||
| "None" | Cette constante permet d'indiquer qu'il n'y a aucune ligne. | ||
| "Horizontal" | Cette constante permet d'indiquer des lignes horizontals. | ||
| "Vertical" | Cette constante permet d'indiquer des lignes verticales. | ||
| "Both" | Cette constante permet d'indiquer des lignes horizontales et verticales. | ||
| Height=valeur | Ce paramètre permet d'indiquer la hauteur de la balise. | ||
| HorizontalAlign=valeur | Ce paramètre permet d'indiquer l'alignement horizontal du tableau : | ||
| Constante | Description | ||
| "NotSet" | Cette constante permet d'indiquer qu'il n'est pas aligné. | ||
| "Left" | Cette constante permet d'indiquer qu'il est aligné à gauche. | ||
| "Center" | Cette constante permet d'indiquer qu'il est aligné au centre. | ||
| "Justify" | Cette constante permet d'indiquer qu'il est justifié. | ||
| "Right" | Cette constante permet d'indiquer qu'il est aligné à droite. | ||
| ID=identificateur | Ce paramètre de balise permet d'indiquer l'identificateur de cette balise. | ||
| OnDataBinding=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de DataBinding. | ||
| OnDisposed=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de disposition. | ||
| OnInit=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement d'initialisation. | ||
| OnLoad=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de chargement. | ||
| OnPreRender=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de pré-rendu. | ||
| OnUnload=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de déchargement. | ||
| runat=valeur | Ce paramètre permet d'indiquer où doit être exécuté la balise : | ||
| Constante | Description | ||
| "server" | Cette constante permet d'indiquer qu'il faut exécuter la balise du côté serveur. | ||
| SkinID=valeur | Ce paramètre permet d'indiquer l'identificateur de Skin. | ||
| Style=valeur | Ce paramètre de balise permet d'indiquer des paramètres de feuille de style associé avec cette balise. | ||
| TabIndex=valeur | Ce paramètre de balise permet d'indiquer l'ordre de sélection des champs et éléments dans un formulaire. | ||
| ToolTip=valeur | Ce paramètre de balise permet d'indiquer l'info-bulle. | ||
| Visible=valeur | Ce paramètre permet d'indiquer si la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que la balise est affiché. | ||
| Width=valeur | Ce paramètre de balise permet d'indiquer la largeur de la balise. | ||
Description
Cette balise permet de définir un tableau.
Remarques
- Le contrôle <asp:Table> permet de créer dynamiquement des tableaux HTML en ASP.NET. Contrairement à un tableau statique en HTML, il peut être rempli et modifié côté serveur en fonction du contexte ou des données.
- Chaque tableau peut contenir plusieurs lignes (TableRow) et chaque ligne, plusieurs cellules (TableCell). Cela permet une structure très flexible s'adaptant bien à des affichages de données complexes.
- La déclaration <asp:Table> doit obligatoirement contenir l'attribut runat="server" pour être interprétée comme un contrôle ASP.NET. Sinon, elle sera considérée comme un simple élément HTML.
- Le contrôle peut être utilisé pour créer des tableaux dynamiques en code-behind, notamment en C#. Cela est utile pour générer des rapports ou tableaux personnalisés à la volée selon des requêtes SQL, par exemple.
- Il est possible de modifier l'apparence du tableau à l'aide de propriétés comme BorderStyle, GridLines, CellPadding, CellSpacing ou encore CssClass, pour mieux l'intégrer dans le design global d'un site.
- Les lignes et les cellules peuvent être ajoutées dans le code-behind avec Table.Rows.Add() et TableCell.Controls.Add(). Cela permet de mélanger du contenu statique et des contrôles interactifs.
- Le tableau peut accueillir d'autres contrôles ASP.NET à l'intérieur de ses cellules. On peut ainsi y intégrer des boutons, des zones de texte, ou des liens hypertextes dynamiques.
- La gestion dynamique du contenu rend le contrôle <asp:Table> très pratique pour des interfaces administratives ou des tableaux de bord, où les données changent fréquemment.
- La propriété GridLines permet de définir si les lignes du tableau doivent être affichées, et comment : aucune, uniquement horizontales, verticales ou les deux. Cela influence la lisibilité du tableau.
- Il est recommandé d'utiliser une boucle pour générer le contenu d'un tableau lorsqu'il dépend d'une source de données externe. Cela évite le code redondant et rend l'application plus maintenable.
- On peut également utiliser le contrôle pour afficher des résultats calculés ou des statistiques, en ajoutant dynamiquement des lignes de résumé ou des entêtes personnalisés.
- Le contrôle <asp:Table> peut être stylisé avec du CSS ou des thèmes ASP.NET (via la propriété SkinID) pour assurer une cohérence graphique sur l'ensemble de l'application.
- Il est aussi possible de fusionner des cellules horizontalement (ColumnSpan) ou verticalement (RowSpan), ce qui permet de reproduire des mises en page plus complexes dans le tableau.
- Les cellules peuvent contenir aussi bien du texte que des contrôles serveur comme des Label, TextBox ou des listes déroulantes, ce qui en fait un excellent support pour les formulaires tabulaires.
- Pour une gestion plus poussée, il est possible de parcourir et modifier dynamiquement chaque cellule ou chaque ligne via une itération dans Table.Rows, ce qui donne un contrôle total sur la structure.
Exemple
Voici un exemple montrant comment afficher un tableau avec une bordure :
- <%@ Page Language="vb" %>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html xmlns="http://www.w3.org/1999/xhtml">
- <body>
- <asp:Table id="MyTable" runat="server" border="2">
- <asp:TableHeaderRow>
- <asp:TableCell><b>Nom</b></asp:TableCell>
- <asp:TableCell><b>Diamètre en KM</b></asp:TableCell>
- <asp:TableCell><b>Proportion avec la terre</b></asp:TableCell>
- <asp:TableCell><b>Rayon</b></asp:TableCell>
- </asp:TableHeaderRow>
- <asp:TableRow runat="server">
- <asp:TableCell runat="server">Mercury</asp:TableCell>
- <asp:TableCell runat="server">4878</asp:TableCell>
- <asp:TableCell runat="server">0,38</asp:TableCell>
- <asp:TableCell runat="server">2439,00</asp:TableCell>
- </asp:TableRow>
- <asp:TableRow runat="server">
- <asp:TableCell runat="server">Vénus</asp:TableCell>
- <asp:TableCell runat="server">12102</asp:TableCell>
- <asp:TableCell runat="server">0,95</asp:TableCell>
- <asp:TableCell runat="server">6051,00</asp:TableCell>
- </asp:TableRow>
- <asp:TableRow runat="server">
- <asp:TableCell runat="server">Terre</asp:TableCell>
- <asp:TableCell runat="server">12756</asp:TableCell>
- <asp:TableCell runat="server">1,00</asp:TableCell>
- <asp:TableCell runat="server">6378,00</asp:TableCell>
- </asp:TableRow>
- </asp:Table>
- </body>
- </html>
on obtiendra le résultat semblable suivant :
|
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017