Cette documentation est archivée et n’est pas conservée.

TableHeaderRow, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Représente une ligne d'en-tête dans un contrôle Table.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class TableHeaderRow : TableRow
public class TableHeaderRow extends TableRow
public class TableHeaderRow extends TableRow

La classe TableHeaderRow représente une ligne d'en-tête dans un contrôle Table. Cette classe prend en charge l'affichage de tableaux sur les périphériques avec une taille d'écran limitée. Sur ces périphériques, un tableau avec de nombreuses colonnes et lignes doit être rendu sur plusieurs pages. L'ajout d'un TableHeaderRow à un contrôle Table vous permet de spécifier une ligne d'en-tête qui est rendue comme première ligne sur chaque page qui affiche une vue du tableau. Pour plus d'informations sur les formats d'affichage d'un tableau rendu sur un périphérique avec une taille d'écran limitée, consultez Table.

Un objet TableHeaderRow peut contenir uniquement des objets TableCell. Pour ajouter le contenu au TableHeaderRow, vous devez ajouter un ou plusieurs objets TableCell à la ligne. Ensuite, définissez la propriété Text de chaque objet TableCell dans la ligne pour spécifier le contenu de chaque cellule. Vous pouvez également ajouter un contrôle à un objet TableCell pour spécifier son contenu.

Vous pouvez gérer les cellules du TableHeaderRow par programme à l'aide de la collection Cells. La collection Cells est une collection d'objets TableCell qui représentent les cellules dans la ligne.

Le TableHeaderRow hérite des propriétés de TableRow qui vous permettent de contrôler comment le contenu de la ligne s'affiche. Par exemple, vous pouvez utiliser les propriétés HorizontalAlign et VerticalAlign pour spécifier l'alignement du contenu.

L'exemple de code suivant décrit la syntaxe déclarative pour créer un contrôle Table qui a un TableHeaderRow et un TableFooterRow.

<%@ Page Language="VB" %>

<html>
    <body>
        <form ID="Form1" runat="server">
        
            <h3>TableHeaderRow and TableFooterRow Example</h3>
              
            <asp:table id="Table1" runat="server" 
                CellPadding="3" 
                CellSpacing="3"
                runat="server">
                
                <asp:TableHeaderRow id=Table1HeaderRow 
                    runat="server">
                    <asp:TableCell Text="The header row."></asp:TableCell>
                </asp:TableHeaderRow>              
                 
                <asp:TableRow>
                    <asp:TableCell Text="(0,0)"></asp:TableCell>
                    <asp:TableCell Text="(0,1)"></asp:TableCell>
                    <asp:TableCell Text="(0,2)"></asp:TableCell>
                </asp:TableRow>
                
                <asp:TableRow>
                    <asp:TableCell Text="(1,0)"></asp:TableCell>
                    <asp:TableCell Text="(1,1)"></asp:TableCell>
                    <asp:TableCell Text="(1,2)"></asp:TableCell>
                </asp:TableRow> 
                
                <asp:TableFooterRow id="Table1FooterRow"
                    runat="server">
                    <asp:TableCell Text="The footer row."></asp:TableCell>
                </asp:TableFooterRow>                               
                                                   
            </asp:table>
                        
        </form>
    </body>
</html>

L'exemple de code suivant montre comment créer par programme un contrôle Table qui a un TableHeaderRow et un TableFooterRow.

RemarqueRemarque

L'exemple de code suivant utilise un modèle de code de fichier unique ; il est possible qu'il ne fonctionne pas correctement s'il est directement copié dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide doté d'une extension .aspx. Pour plus d'informations sur le modèle de code Web Forms, consultez Modèle de code des pages Web ASP.NET.

<%@ Page Language="VB" %>

<html>
    <head>
        <script runat="server">
            Private Sub Page_Load(sender As Object, e As System.EventArgs)
                
                ' Add rows to the table.
                Dim i As Integer
                For i = 0 To 100
                    Dim tempRow As New TableRow
                    Dim j As Integer
                    For j = 0 To 2
                        Dim tempCell As New TableCell
                        tempCell.Text = "(" & i & "," & j & ")"
                        tempRow.Cells.Add(tempCell)
                    Next j
                    Table1.Rows.Add(tempRow)
                Next i
                
                ' Create a TableHeaderRow.
                Dim headerRow As New TableHeaderRow
                
                ' Create TableCell objects to contain the text for the header.
                Dim headerTableCell1 As New TableCell
                Dim headerTableCell2 As New TableCell
                Dim headerTableCell3 As New TableCell
                headerTableCell1.Text = "Column 1 header"
                headerTableCell2.Text = "Column 2 header"
                headerTableCell3.Text = "Column 3 header"
                
                ' Add the TableCell objects to the Cells
                ' collection of the TableHeaderRow.
                headerRow.Cells.Add(headerTableCell1)
                headerRow.Cells.Add(headerTableCell2)
                headerRow.Cells.Add(headerTableCell3)

                ' Add the TableHeaderRow as the first item 
                ' in the Rows collection of the table.
                Table1.Rows.AddAt(0, headerRow)
                
                ' Create a TableFooterRow.
                Dim footerRow As New TableFooterRow
                
                ' Create TableCell objects to contain the text for the footer.
                Dim footerTableCell1 As New TableCell
                Dim footerTableCell2 As New TableCell
                Dim footerTableCell3 As New TableCell
                footerTableCell1.Text = "Column 1 footer"
                footerTableCell2.Text = "Column 2 footer"
                footerTableCell3.Text = "Column 3 footer"

                ' Add the TableCell objects to the Cells
                ' collection of the TableFooterRow.
                footerRow.Cells.Add(footerTableCell1)
                footerRow.Cells.Add(footerTableCell2)
                footerRow.Cells.Add(footerTableCell3)

                ' Add the TableFooterRow to the Rows
                ' collection of the table.
                Table1.Rows.Add(footerRow)
                
            End Sub
        </script>
    </head>

    <body>
        <form ID="Form1" runat="server">
        
            <h3>TableHeaderRow and TableFooterRow Example</h3>
              
            <asp:table id="Table1"  
                CellPadding="3" 
                CellSpacing="3"
                Gridlines="Both"
                runat="server">                                                          
            </asp:table>
            
        </form>
    </body>
</html>

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de la demande : LinkDemand. Valeur d'autorisation : Minimal.
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de la demande : InheritanceDemand. Valeur d'autorisation : Minimal.

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.TableRow
        System.Web.UI.WebControls.TableHeaderRow

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: