HtmlTableCellCollection-Klasse
Eine Auflistung von HtmlTableCell-Objekten, die die Zellen in einer einzelnen Zeile 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 HtmlTableCellCollection
Implements ICollection, IEnumerable
'Usage
Dim instance As HtmlTableCellCollection
public sealed class HtmlTableCellCollection : ICollection, IEnumerable
public ref class HtmlTableCellCollection sealed : ICollection, IEnumerable
public final class HtmlTableCellCollection implements ICollection, IEnumerable
public final class HtmlTableCellCollection implements ICollection, IEnumerable
Hinweise
Verwenden Sie die HtmlTableCellCollection-Klasse zur programmgesteuerten Verwaltung einer Auflistung von HtmlTableCell-Objekten, die die Zellen in einer einzelnen Zeile eines HtmlTable-Steuerelements darstellen. Diese Klasse wird häufig zum Hinzufügen, Entfernen oder Ändern des Inhalts einer Zelle in einer Zeile eines HtmlTable-Steuerelements verwendet.
Hinweis
Ein HtmlTable-Steuerelement enthält eine Rows-Eigenschaft, die eine Auflistung von HtmlTableRow-Objekten enthält. Jedes HtmlTableRow-Objekt stellt eine einzelne Zeile in der Tabelle dar. Ein HtmlTableRow-Objekt enthält eine Cells-Eigenschaft, die eine Auflistung von HtmlTableCell-Objekten darstellt. Diese Objekte stellen wiederum die einzelnen Zellen einer Zeile dar. Zum Abrufen einer einzelnen Zelle rufen Sie zuerst das HtmlTableRow-Objekt ab, das die Zeile mit der Zelle in der Tabelle darstellt (aus der Rows-Auflistung des HtmlTable-Steuerelements). Anschließend können Sie das HtmlTableCell-Objekt abrufen, das die Zelle in der Zeile darstellt (aus der Cells-Auflistung des HtmlTableRow-Objekts).
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie der Inhalt eines HtmlTable-Steuerelements durch Hinzufügen von Zellen zu einer HtmlTableCellCollection-Auflistung dynamisch generiert wird. Beachten Sie, dass die Cells-Eigenschaft einer durch ein HtmlTableRow-Objekt dargestellten Zeile die HtmlTableCellCollection-Auflistung 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>HtmlTableCellCollection Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableCellCollection 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>HtmlTableCellCollection Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableCellCollection 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 : Object, 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>HtmlTableCellCollection Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTableCellCollection 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.HtmlTableCellCollection
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
HtmlTableCellCollection-Member
System.Web.UI.HtmlControls-Namespace
HtmlTable-Klasse
HtmlTable.Rows-Eigenschaft
HtmlTableRow
Cells
HtmlTableCell-Klasse