Questa documentazione è stata archiviata e non viene gestita.

Classe TableHeaderRow

Nota: questa classe è stata introdotta con .NET Framework versione 2.0.

Rappresenta una riga dell'intestazione in un controllo Table.

Spazio dei nomi: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

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

La classe TableHeaderRow rappresenta una riga dell'intestazione in un controllo Table. Questa classe supporta la visualizzazione delle tabelle su periferiche con dimensioni dello schermo limitate. Su queste periferiche il rendering di una tabella con molte colonne e righe deve essere eseguito su più pagine. L'aggiunta di una classe TableHeaderRow a un controllo Table consente di specificare una riga dell'intestazione che viene visualizzata come prima riga in tutte le pagine contenenti una vista della tabella. Per ulteriori informazioni sui formati di visualizzazione di una tabella visualizzata su una periferica con dimensioni dello schermo limitate, vedere Table.

Un oggetto TableHeaderRow può contenere solo oggetti TableCell. Per aggiungere contenuto all'oggetto TableHeaderRow, è necessario aggiungere uno o più oggetti TableCell alla riga. Impostare quindi la proprietà Text di ciascun oggetto TableCell della riga in modo da specificare il contenuto di ogni cella. In alternativa, è possibile aggiungere un controllo a un oggetto TableCell per specificarne il contenuto.

È possibile gestire a livello di codice le celle all'interno dell'oggetto TableHeaderRow tramite l'insieme Cells. L'insieme Cells è un insieme di oggetti TableCell che rappresentano le celle all'interno della riga.

La classe TableHeaderRow eredita da TableRow le proprietà che consentono di controllare la modalità di visualizzazione del contenuto della riga. È possibile ad esempio utilizzare le proprietà HorizontalAlign e VerticalAlign per specificare l'allineamento del contenuto.

Nell'esempio di codice riportato di seguito viene illustrata la sintassi dichiarativa per la creazione di un controllo Table con una classe TableHeaderRow e una classe 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>

Nell'esempio di codice riportato di seguito viene illustrato come creare a livello di codice un controllo Table con una classe TableHeaderRow e una classe TableFooterRow.

NotaNota

Nell'esempio di codice riportato di seguito viene utilizzato il modello di codice a file singolo e se viene copiato direttamente in un file di codice sottostante, il codice potrebbe non funzionare. È necessario copiare l'esempio di codice in un file di testo vuoto con estensione ASPX. Per ulteriori informazioni sul modello di codice di Web Form, vedere Modello di codice di pagine 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  per operare in un ambiente host. Valore richiesta: LinkDemand. Valore autorizzazione: Minimal.
  • AspNetHostingPermission  per operare in un ambiente host. Valore richiesta: InheritanceDemand. Valore autorizzazione: Minimal.

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

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0
Mostra: