Table.Rows-Eigenschaft
Ruft die Auflistung der Zeilen im Table-Steuerelement ab.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Overridable ReadOnly Property Rows As TableRowCollection
'Usage
Dim instance As Table
Dim value As TableRowCollection
value = instance.Rows
public virtual TableRowCollection Rows { get; }
public:
virtual property TableRowCollection^ Rows {
TableRowCollection^ get ();
}
/** @property */
public TableRowCollection get_Rows ()
public function get Rows () : TableRowCollection
Eigenschaftenwert
Eine TableRowCollection, die die TableRow-Objekte im Table-Steuerelement enthält.
Hinweise
Mit der Rows-Auflistung können Sie die TableRow-Objekte im Table-Steuerelement programmgesteuert verwalten. Eine TableRow stellt eine Zeile in der Tabelle dar.
Hinweis
Diese Eigenschaft wird normalerweise nur beim programmgesteuerten Erstellen von Tabellen verwendet. Wird zur Entwurfszeit durch Deklarieren von TableRow-Objekten zwischen den öffnenden und schließenden Tags des Table-Steuerelements festgelegt.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie eine Tabelle mithilfe der Rows-Auflistung programmgesteuert erstellt wird. Das dynamische Erstellen einer Tabelle beinhaltet drei Schritte. Erstellen Sie zunächst TableCell-Objekte, die die Zellen in einer Zeile darstellen. Geben Sie den Inhalt der Zellen entweder durch Festlegen der Text-Eigenschaft ein oder indem Sie der Control.Controls-Auflistung der TableCell Steuerelemente hinzufügen. Erstellen Sie anschließend eine TableRow, die eine Zeile in der Tabelle darstellt. Fügen Sie nun der Cells-Auflistung der TableRow die zuvor erstellten TableCell-Objekte hinzu. Fügen Sie abschließend der Rows-Auflistung des Table-Steuerelements die TableRow hinzu. Wiederholen Sie diesen Prozess für jede Zeile in der Tabelle.
Hinweis
Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script language="VB" 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.Controls.Add(New LiteralControl("row " & j.ToString() & ", cell " & i.ToString()))
r.Cells.Add(c)
Next i
Table1.Rows.Add(r)
Next j
End Sub 'Page_Load
</script>
</head>
<body>
<h3>Table Example, constructed programmatically</h3>
<form runat=server>
<asp:Table id="Table1"
GridLines="Both"
HorizontalAlign="Center"
Font-Name="Verdana"
Font-Size="8pt"
CellPadding=15
CellSpacing=0
Runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<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.Controls.Add(new LiteralControl("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"
GridLines="Both"
HorizontalAlign="Center"
Font-Name="Verdana"
Font-Size="8pt"
CellPadding=15
CellSpacing=0
Runat="server"/>
</form>
</body>
</html>
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
Table-Klasse
Table-Member
System.Web.UI.WebControls-Namespace
TableRow
TableRowCollection