TableCellCollection.GetEnumerator-Methode
Gibt ein System.Collections.IEnumerator-implementiertes Objekt zurück, das alle TableCell-Objekte in TableCellCollection enthält.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Function GetEnumerator As IEnumerator
'Usage
Dim instance As TableCellCollection
Dim returnValue As IEnumerator
returnValue = instance.GetEnumerator
public IEnumerator GetEnumerator ()
public:
virtual IEnumerator^ GetEnumerator () sealed
public final IEnumerator GetEnumerator ()
public final function GetEnumerator () : IEnumerator
Rückgabewert
Ein System.Collections.IEnumerator-implementiertes Objekt, das alle TableCell-Objekte in TableCellCollection enthält.
Hinweise
Mit dieser Methode können Sie ein System.Collections.IEnumerator-implementiertes Objekt erstellen, das zum Abrufen jedes einzelnen Elements in TableCellCollection durchlaufen werden kann.
Mit der IEnumerator.Current-Eigenschaft können Sie das Element der Auflistung abrufen, auf das momentan gezeigt wird.
Mit der IEnumerator.MoveNext-Methode können Sie zum nächsten Element in der Auflistung wechseln.
Mit der IEnumerator.Reset-Methode verschieben Sie den Enumerator zurück zur Anfangsposition.
Hinweis
Die IEnumerator.MoveNext-Methode muss aufgerufen werden, nachdem ein implementiertes System.Collections.IEnumerator-Objekt erstellt oder der Enumerator mit der IEnumerator.Reset-Methode zum ersten Element in der Auflistung verschoben wurde. Andernfalls ist das durch die IEnumerator.Current-Eigenschaft dargestellte Element nicht definiert.
Beispiel
Das folgende Beispiel veranschaulicht, wie mit der GetEnumerator-Methode ein System.Collections.IEnumerator-implementiertes Objekt erstellt wird. Dieses wird anschließend durchlaufen, um die Elemente in der ausgewählten Zeile anzuzeigen.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub Page_Load(sender As Object, e As EventArgs)
Dim numrows As Integer = 5
Dim numcells As Integer = 6
Dim counter As Integer = 1
Dim a_row As New ArrayList()
' Create a table.
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()
r.Cells.Add(c)
counter += 1
Next i
Table1.Rows.Add(r)
Next j
If Not IsPostBack Then
' Create a DropDownList for the number of rows.
Dim k As Integer
For k = 0 To numrows - 1
a_row.Add(k.ToString())
Next k
List1.DataSource = a_row
List1.DataBind()
End If
End Sub
Sub Button_Click(sender As Object, e As EventArgs)
Dim row As Integer = List1.SelectedIndex
Dim current_cell As TableCell
' Create the IEnumerator.
Dim myEnum As IEnumerator = Table1.Rows(row).Cells.GetEnumerator()
Label1.Text = "The items in the selected row are: "
' Iterate through the IEnumerator and display its contents.
While myEnum.MoveNext()
current_cell = CType(myEnum.Current, TableCell)
Label1.Text = Label1.Text & " " & current_cell.Text
End While
End Sub
</script>
</head>
<body>
<h3>TableCellCollection Example</h3>
<form runat=server>
<asp:Table id="Table1"
runat="server"/>
<br><br>
<center>
Select a row:
<br><br>
Row:
<asp:DropDownList id="List1"
runat="server"/>
<br><br>
<asp:Button id="Button1"
Text="Create IEnumerator"
OnClick="Button_Click"
runat="server"/>
<br><br>
<asp:Label id="Label1"
runat="server"/>
</center>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void Page_Load(Object sender, EventArgs e)
{
int numrows = 5;
int numcells = 6;
int counter = 1;
ArrayList a_row = new ArrayList();
// Create a table.
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();
r.Cells.Add(c);
counter++;
}
Table1.Rows.Add(r);
}
if (!IsPostBack)
{
// Create a DropDownList for the number of rows.
for (int k=0; k<numrows; k++)
{
a_row.Add(k.ToString());
}
List1.DataSource=a_row;
List1.DataBind();
}
}
void Button_Click(object sender, EventArgs e)
{
int row = List1.SelectedIndex;
TableCell current_cell;
// Create the IEnumerator.
IEnumerator myEnum = Table1.Rows[row].Cells.GetEnumerator();
Label1.Text = "The items in the selected row are: ";
// Iterate through the IEnumerator and display its contents.
while (myEnum.MoveNext())
{
current_cell = (TableCell)myEnum.Current;
Label1.Text = Label1.Text + " " + current_cell.Text;
}
}
</script>
</head>
<body>
<h3>TableCellCollection Example</h3>
<form runat=server>
<asp:Table id="Table1"
runat="server"/>
<br><br>
<center>
Select a row:
<br><br>
Row:
<asp:DropDownList id="List1"
runat="server"/>
<br><br>
<asp:Button id="Button1"
Text="Create IEnumerator"
OnClick="Button_Click"
runat="server"/>
<br><br>
<asp:Label id="Label1"
runat="server"/>
</center>
</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
TableCellCollection-Klasse
TableCellCollection-Member
System.Web.UI.WebControls-Namespace
System.Collections.IEnumerator
TableCell-Klasse
IEnumerator.Current
IEnumerator.MoveNext
IEnumerator.Reset