HtmlTableRowCollection-Klasse
Eine Auflistung von HtmlTableRow-Objekten, die die Zeilen eines HtmlTable-Steuerelements darstellen. Diese Klasse kann nicht vererbt werden.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public NotInheritable Class HtmlTableRowCollection
Implements ICollection, IEnumerable
'Usage
Dim instance As HtmlTableRowCollection
public sealed class HtmlTableRowCollection : ICollection, IEnumerable
public ref class HtmlTableRowCollection sealed : ICollection, IEnumerable
public final class HtmlTableRowCollection implements ICollection, IEnumerable
public final class HtmlTableRowCollection implements ICollection, IEnumerable
Hinweise
Mit der HtmlTableRowCollection-Klasse können Sie programmgesteuert eine Auflistung von HtmlTableRow-Objekten verwalten, die die Zeilen in einem HtmlTable-Steuerelement darstellen. Diese Klasse wird i. Allg. zum Hinzufügen, Entfernen oder Ändern des Inhalts einer Zeile in einem HtmlTable-Steuerelement verwendet.
Hinweis
Ein HtmlTable-Steuerelement enthält eine Rows-Eigenschaft, die eine Auflistung von HtmlTableRow-Objekten darstellt. Jede HtmlTableRow stellt eine einzelne Zeile in der Tabelle dar. Eine HtmlTableRow enthält eine Cells-Eigenschaft, die eine Auflistung von HtmlTableCell-Objekten darstellt. Diese Objekte stellen wiederum die einzelnen Zellen der Tabelle dar. Zum Abrufen einer einzelnen Zelle rufen Sie zuerst aus der Rows-Auflistung des HtmlTable-Steuerelements das HtmlTableRow-Objekt ab, das die Zeile mit der Zelle darstellt. Anschließend können Sie aus der Cells-Auflistung von HtmlTableRow das HtmlTableCell-Objekt abrufen, das die Zelle in der Zeile darstellt.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie der Inhalt eines HtmlTable-Steuerelements durch Hinzufügen von Zeilen zu einer HtmlTableRowCollection-Auflistung dynamisch generiert wird. Beachten Sie, dass die Rows-Eigenschaft einer Tabelle das HtmlTableRowCollection-Objekt ist.
<%@ Page Language="VB" AutoEventWireup="True" %>
<script runat="server">
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
Dim i As Integer
Dim j As Integer
Dim row As HtmlTableRow
Dim cell As HtmlTableCell
' Get the number of rows and columns selected by the user.
Dim numrows As Integer = CInt(Select1.Value)
Dim numcells As Integer = CInt(Select2.Value)
' Iterate through the rows.
For j = 0 To numrows - 1
' Create a new row and add it to the Rows collection.
row = New HtmlTableRow()
' Provide a different background color for alternating rows.
If (j Mod 2) = 1 Then
row.BgColor = "Gray"
End If
' Iterate through the cells of a row.
For i = 0 To numcells - 1
' Create a new cell and add it to the Cells collection.
cell = New HtmlTableCell()
cell.Controls.Add(New LiteralControl("row " & _
j.ToString() & _
", cell " & _
i.ToString()))
row.Cells.Add(cell)
Next i
Table1.Rows.Add(row)
Next j
End Sub
</script>
<html>
<head>
<title>HtmlTableRowCollection Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableRowCollection Example</h3>
<table id="Table1"
cellpadding="5"
cellspacing="0"
border="1"
bordercolor="black"
runat="server"/>
<hr>
Select the number of rows and columns to create: <br><br>
Table rows:
<select id="Select1"
runat="server">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
Table cells:
<select id="Select2"
runat="server">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
<br><br>
<input type="submit"
value="Generate Table"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<script runat="server">
void Page_Load(Object sender, EventArgs e)
{
// Get the number of rows and columns selected by the user.
int numrows = Convert.ToInt32(Select1.Value);
int numcells = Convert.ToInt32(Select2.Value);
// Iterate through the rows.
for (int j = 0; j < numrows; j++)
{
// Create a new row and add it to the Rows collection.
HtmlTableRow row = new HtmlTableRow();
// Provide a different background color for alternating rows.
if (j % 2 == 1)
row.BgColor = "Gray";
// Iterate through the cells of a row.
for (int i = 0; i < numcells; i++)
{
// Create a new cell and add it to the Cells collection.
HtmlTableCell cell = new HtmlTableCell();
cell.Controls.Add(new LiteralControl("row " +
j.ToString() +
", cell " +
i.ToString()));
row.Cells.Add(cell);
}
Table1.Rows.Add(row);
}
}
</script>
<html>
<head>
<title>HtmlTableRowCollection Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableRowCollection Example</h3>
<table id="Table1"
cellpadding="5"
cellspacing="0"
border="1"
bordercolor="black"
runat="server"/>
<hr>
Select the number of rows and columns to create: <br><br>
Table rows:
<select id="Select1"
runat="server">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
Table cells:
<select id="Select2"
runat="server">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
<br><br>
<input type="submit"
value="Generate Table"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<script runat="server">
function Page_Load(sender, e : EventArgs)
{
// Get the number of rows and columns selected by the user.
var numrows : int = Convert.ToInt32(Select1.Value);
var numcells : int = Convert.ToInt32(Select2.Value);
// Iterate through the rows.
for (var j : int =0; j<numrows; j++)
{
// Create a new row and add it to the Rows collection.
var row : HtmlTableRow = new HtmlTableRow();
// Provide a different background color for alternating rows.
if (j%2 == 1)
row.BgColor="Gray";
// Iterate through the cells of a row.
for (var i : int =0; i<numcells; i++)
{
// Create a new cell and add it to the Cells collection.
var cell : HtmlTableCell = new HtmlTableCell();
cell.Controls.Add(new LiteralControl("row " +
j.ToString() +
", cell " +
i.ToString()));
row.Cells.Add(cell);
}
Table1.Rows.Add(row);
}
}
</script>
<html>
<head>
<title>HtmlTableRowCollection Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableRowCollection Example</h3>
<table id="Table1"
cellpadding="5"
cellspacing="0"
border="1"
bordercolor="black"
runat="server"/>
<hr>
Select the number of rows and columns to create: <br><br>
Table rows:
<select id="Select1"
runat="server">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
Table cells:
<select id="Select2"
runat="server">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
</select>
<br><br>
<input type="submit"
value="Generate Table"
runat="server"/>
</form>
</body>
</html>
.NET Framework-Sicherheit
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
Vererbungshierarchie
System.Object
System.Web.UI.HtmlControls.HtmlTableRowCollection
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
HtmlTableRowCollection-Member
System.Web.UI.HtmlControls-Namespace
HtmlTable-Klasse
HtmlTable.Rows-Eigenschaft
HtmlTableRow-Klasse
HtmlTableRow.Cells-Eigenschaft
HtmlTableCell-Klasse