TableCellCollection-Klasse
Kapselt eine Auflistung von TableHeaderCell-Objekten und TableCell-Objekten, die eine Zeile in einem Table-Steuerelement bilden. Diese Klasse kann nicht geerbt werden.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public NotInheritable Class TableCellCollection
Implements IList, ICollection, IEnumerable
'Usage
Dim instance As TableCellCollection
public sealed class TableCellCollection : IList, ICollection, IEnumerable
public ref class TableCellCollection sealed : IList, ICollection, IEnumerable
public final class TableCellCollection implements IList, ICollection,
IEnumerable
public final class TableCellCollection implements IList, ICollection,
IEnumerable
Hinweise
Diese Klasse ermöglicht das programmgesteuerte Verwalten einer Auflistung von TableCell-Objekten, die eine Zeile in einem Table-Steuerelement bilden. Diese Klasse wird in der Regel verwendet, um einer Zeile in einem Table-Steuerelement Zellen 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 TableRow aus der Rows-Auflistung eines Table-Steuerelements abgerufen werden. Sie können TableCell aus der Cells-Auflistung von TableRow abrufen.
Beispiel
Das folgende Beispiel veranschaulicht, wie ein Table-Steuerelement programmgesteuert gefüllt wird. Durch die Cells-Eigenschaft werden TableCell-Objekte, die einzelne Zellen darstellen, TableRow-Objekten hinzugefügt, die die einzelnen Zeilen 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 = 4
Dim numcells As Integer = 6
Dim counter As Integer = 1
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 = counter.ToString()
counter += 1
r.Cells.Add(c)
Next i
Table1.Rows.Add(r)
Next j
End Sub
Sub Button_Click_Coord(sender As Object, e As EventArgs)
Dim i As Integer
For i = 0 To Table1.Rows.Count - 1
Dim j As Integer
For j = 0 To (Table1.Rows(i).Cells.Count) - 1
Table1.Rows(i).Cells(j).Text = "(" & j.ToString() & _
", " & i.ToString() & ")"
Next j
Next i
End Sub
Sub Button_Click_Number(sender As Object, e As EventArgs)
Dim counter As Integer = 1
Dim i As Integer
For i = 0 To Table1.Rows.Count - 1
Dim j As Integer
For j = 0 To (Table1.Rows(i).Cells.Count) - 1
Table1.Rows(i).Cells(j).Text = counter.ToString()
counter += 1
Next j
Next i
End Sub
</script>
</head>
<body>
<h3>TableCellCollection Example</h3>
<form runat="server">
<asp:Table id="Table1"
runat="server"/>
<br>
<center>
<asp:Button id="Button1"
Text="Display Table Coordinates"
OnClick="Button_Click_Coord"
runat="server"/>
<asp:Button id="Button2"
Text="Display Cell Numbers"
OnClick="Button_Click_Number"
runat="server"/>
</center>
</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 = 4;
int numcells = 6;
int counter = 1;
for (int j=0; j<numrows; j++)
{
TableRow r = new TableRow();
for (int i=0; i<numcells; i++)
{
TableCell c = new TableCell();
c.Text=counter.ToString();
counter++;
r.Cells.Add(c);
}
Table1.Rows.Add(r);
}
}
void Button_Click_Coord(object sender, EventArgs e)
{
for (int i=0; i<Table1.Rows.Count; i++)
{
for (int j=0; j<Table1.Rows[i].Cells.Count; j++)
{
Table1.Rows[i].Cells[j].Text = "(" +
j.ToString() + ", " + i.ToString() + ")";
}
}
}
void Button_Click_Number(object sender, EventArgs e)
{
int counter = 1;
for (int i=0; i<Table1.Rows.Count; i++)
{
for (int j=0; j<Table1.Rows[i].Cells.Count; j++)
{
Table1.Rows[i].Cells[j].Text = counter.ToString();
counter++;
}
}
}
</script>
</head>
<body>
<h3>TableCellCollection Example</h3>
<form runat="server">
<asp:Table id="Table1"
runat="server"/>
<br>
<center>
<asp:Button id="Button1"
Text="Display Table Coordinates"
OnClick="Button_Click_Coord"
runat="server"/>
<asp:Button id="Button2"
Text="Display Cell Numbers"
OnClick="Button_Click_Number"
runat="server"/>
</center>
</form>
</body>
</html>
.NET Framework-Sicherheit
- AspNetHostingPermission Für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
Vererbungshierarchie
System.Object
System.Web.UI.WebControls.TableCellCollection
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
TableCellCollection-Member
System.Web.UI.WebControls-Namespace
TableRow
Table.Rows-Eigenschaft
TableCell-Klasse
Cells
TableHeaderCell
Table-Klasse
TableCellCollection-Klasse