ASP:TABLEROW |
ASP : Enregistrement de tableau |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:TableCell paramètres> ... </asp:TableCell> |
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. | ||
| 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. | ||
| 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. | ||
| 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. | ||
| VerticalAlign=valeur | Ce paramètre permet d'indiquer l'alignement vertical du tableau : | ||
| Constante | Description | ||
| "Bottom" | Cette constante permet d'indiquer qu'il faut effectuer un alignement vers le bas du tableau. | ||
| "Middle" | Cette constante permet d'indiquer qu'il faut effectuer un alignement vers le milieu du tableau. | ||
| "NotSet" | Cette constante permet d'indiquer qu'il n'y a pas d'alignement vertical du tableau. | ||
| "Top" | Cette constante permet d'indiquer qu'il faut effectuer un alignement vers le haut du tableau. | ||
| 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 une colonne dans une ligne de tableau.
Remarques
- Le contrôle <asp:TableRow> est utilisé pour représenter une ligne dans un tableau ASP.NET créé avec <asp:Table>. Il est essentiel pour structurer le contenu en ligne, chaque ligne pouvant ensuite contenir plusieurs cellules.
- Une <asp:Table> est composée d'un ensemble de <asp:TableRow>, chacun contenant des balises <asp:TableCell>. Cette hiérarchie imite la structure classique d'un tableau HTML mais avec un contrôle complet côté serveur.
- Le contrôle <asp:TableRow> doit obligatoirement être utilisé à l'intérieur d'un contrôle <asp:Table>. Hors de ce contexte, il n'a pas de sens et générera une erreur à l'exécution.
- Comme pour les autres contrôles serveur, la balise <asp:TableRow> nécessite l'attribut runat="server" pour que son contenu soit traité côté serveur par ASP.NET.
- Chaque instance de TableRow peut être manipulée dynamiquement dans le code-behind, ce qui permet d'ajouter ou de retirer des lignes selon des conditions ou des données issues de bases de données.
- Le développeur peut insérer des cellules (<asp:TableCell>) dans une ligne soit directement dans la balise, soit dynamiquement via TableRow.Cells.Add() dans le code-behind.
- Il est possible de styliser une ligne avec des propriétés comme CssClass, BackColor, ForeColor ou encore Height et HorizontalAlign. Cela permet d'alterner l'apparence des lignes pour une meilleure lisibilité.
- Un cas d'usage typique du contrôle <asp:TableRow> est la création d'un tableau récapitulatif ou d'un tableau d'entrée de données, comme un formulaire structuré.
- Le contrôle permet également d'ajouter du contenu dynamique, comme des boutons ou des zones de texte, dans les cellules d'une ligne. Cela est très utile pour construire des interfaces administratives complexes.
- On peut créer une ligne vide pour espacer visuellement des sections d'un tableau. Il suffit alors d'ajouter une TableRow avec des cellules vides ou dotées d'un .
- Les propriétés de chaque ligne peuvent être définies individuellement, ce qui permet, par exemple, de mettre en surbrillance une ligne spécifique en fonction d'une condition métier (exemple : une alerte ou une erreur).
- Dans une logique de programmation orientée objet, chaque ligne d'un tableau peut être considérée comme un "enregistrement", ce qui permet de mieux structurer et identifier les données affichées.
- Une TableRow peut être créée dans le code C# à l'aide de TableRow ligne = new TableRow();. On peut ensuite lui ajouter des cellules via une boucle avant de l'ajouter au tableau.
- Lors de l'ajout de contenu dynamique, les contrôles insérés dans les cellules d'une TableRow peuvent être dotés de noms uniques pour pouvoir être traités lors d'événements serveur.
- Il est également possible d'assigner un ID à chaque TableRow, ce qui permet de les retrouver plus facilement dans le code et de les manipuler individuellement (exemple : suppression, mise à jour,...).
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017