Freigeben über


TableRowCollection-Klasse

Kapselt eine Auflistung von TableRow-Objekten, die eine einzelne Zeile in einem Table-Steuerelement darstellen. Diese Klasse kann nicht geerbt werden.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public NotInheritable Class TableRowCollection
    Implements IList, ICollection, IEnumerable
'Usage
Dim instance As TableRowCollection
public sealed class TableRowCollection : IList, ICollection, IEnumerable
public ref class TableRowCollection sealed : IList, ICollection, IEnumerable
public final class TableRowCollection implements IList, ICollection, 
    IEnumerable
public final class TableRowCollection implements IList, ICollection, 
    IEnumerable

Hinweise

Mit dieser Klasse können Sie eine Auflistung von TableRow-Objekten programmgesteuert verwalten. Diese Klasse wird in der Regel verwendet, um einem Table-Steuerelement Zeilen hinzuzufügen oder diese daraus zu entfernen.

Hinweis

Ein Table-Steuerelement enthält eine Rows-Auflistung, die eine Auflistung von TableRow-Objekten darstellt. Jede TableRow stellt eine einzelne Zeile in der Tabelle dar und enthält eine Cells-Auflistung, die eine Auflistung von TableCell-Objekten enthält. Diese TableCell-Objekte stellen die einzelnen Zellen in der Tabelle dar. Zum Abrufen einer einzelnen Zelle muss zunächst eine TableRow aus der Rows-Auflistung eines Table-Steuerelements abgerufen werden. Sie können eine TableCell aus der Cells-Auflistung der TableRow abrufen.

Beispiel

Das folgende Beispiel veranschaulicht, wie einer Tabelle programmgesteuert Zeilen hinzugefügt werden, indem dem Table-Steuerelement mithilfe der Rows-Eigenschaft TableRow-Objekte hinzugefügt werden, die die Zeilen der Tabelle darstellen.

<%@ Page Language="VB" AutoEventWireup="True" %>

 <html>
 <head>
     <script runat="server">

        Sub Page_Load(sender As Object, e As EventArgs)
            ' Generate rows and cells.           
            Dim numrows As Integer = 3
            Dim numcells As Integer = 2
            Dim j As Integer
            For j = 0 To numrows - 1
                Dim r As New TableRow()
                Dim i As Integer
                For i = 0 To numcells - 1
                    Dim c As New TableCell()
                    c.Text = "row " & j.ToString() & ", cell " & i.ToString()
                    r.Cells.Add(c)
                Next i
                Table1.Rows.Add(r)
            Next j
        End Sub
        
     </script>
 </head>
 <body>
     <h3>Table Example, constructed programmatically</h3>
     <form runat=server>
         <asp:Table id="Table1"
              runat="server"/>
     </form>
 </body>
 </html>
    
<%@ Page Language="C#" AutoEventWireup="True" %>

 <html>
 <head>
     <script runat="server">
         void Page_Load(Object sender, EventArgs e) {
             // Generate rows and cells.           
             int numrows = 3;
             int numcells = 2;
             for (int j=0; j<numrows; j++) {          
                 TableRow r = new TableRow();
                 for (int i=0; i<numcells; i++) {
                     TableCell c = new TableCell();
                     c.Text="row " + j.ToString() + ", cell " + i.ToString();
                     r.Cells.Add(c);
                 }
                 Table1.Rows.Add(r);
             }
         }
     </script>
 </head>
 <body>
     <h3>Table Example, constructed programmatically</h3>
     <form runat=server>
         <asp:Table id="Table1"
              runat="server"/>
     </form>
 </body>
 </html>
    
<html>
<head>
    <script language="C#" runat="server">
        void Page_Load(Object sender, EventArgs e) {
            // Generate rows and cells           
            int numrows = 3;
            int numcells = 2;
            for (int j=0; j<numrows; j++) {          
                TableRow r = new TableRow();
                for (int i=0; i<numcells; i++) {
                    TableCell c = new TableCell();
                    c.Text="row " + j.ToString() + ", cell " + i.ToString();
                    r.Cells.Add(c);
                }
                Table1.Rows.Add(r);
            }
        }
    </script>
</head>
<body>
    <h3><font face="Verdana">Table Example, constructed programmatically</font></h3>
    <form runat=server>
        <asp:Table id="Table1"
             runat="server"/>
    </form>
</body>
</html>
   

.NET Framework-Sicherheit

Vererbungshierarchie

System.Object
  System.Web.UI.WebControls.TableRowCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

TableRowCollection-Member
System.Web.UI.WebControls-Namespace
TableRow-Klasse
Table.Rows-Eigenschaft
TableCell-Klasse
TableRow.Cells-Eigenschaft
Table-Klasse

Weitere Ressourcen

Table-, TableRow- und TableCell-Webserver-Steuerelemente