TableRowCollection.GetEnumerator-Methode
Gibt ein implementiertes System.Collections.IEnumerator-Objekt zurück, das alle TableRow-Objekte in der TableRowCollection 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 TableRowCollection
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 implementiertes System.Collections.IEnumerator-Objekt, dass alle TableRow-Objekte in der TableRowCollection enthält.
Hinweise
Mit dieser Methode können Sie ein implementiertes System.Collections.IEnumerator-Objekt erstellen, das zum Abrufen jedes einzelnen Elements in der TableRowCollection 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 implementiertes System.Collections.IEnumerator-Objekt erstellt wird, das zum Anzeigen der Tabellenelemente durchlaufen wird.
<%@ 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
End Sub
Sub Button_Click(sender As Object, e As EventArgs)
Dim row_counter As Integer = 0
Dim current_row As TableRow
Dim current_cell As TableCell
' Create an IEnumerator for the rows of the table.
Dim myRowEnum As IEnumerator = Table1.Rows.GetEnumerator()
Label1.Text = "The copied items from the table are: "
' Iterate through the IEnumerator and display its contents.
While myRowEnum.MoveNext()
' Create an IEnumerator for the cells of a row.
Dim myCellEnum As IEnumerator = _
Table1.Rows(row_counter).Cells.GetEnumerator()
' Iterate through the IEnumerator and display its contents.
While myCellEnum.MoveNext()
current_cell = CType(myCellEnum.Current, TableCell)
Label1.Text = Label1.Text & " " & current_cell.Text
End While
row_counter += 1
End While
End Sub
</script>
</head>
<body>
<h3>TableCellCollection Example</h3>
<form runat=server>
<asp:Table id="Table1"
runat="server"/>
<br><br>
<center>
<asp:Button id="Button1"
Text="Copy Table to Array"
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);
}
}
void Button_Click(object sender, EventArgs e) {
int row_counter = 0;
TableRow current_row;
TableCell current_cell;
// Create an IEnumerator for the rows of a table.
IEnumerator myRowEnum = Table1.Rows.GetEnumerator();
Label1.Text = "The copied items from the table are: ";
// Iterate through the IEnumerator and display its contents.
while (myRowEnum.MoveNext()) {
// Create an IEnumerator for the cells of the row.
IEnumerator myCellEnum = Table1.Rows[row_counter].Cells.GetEnumerator();
// Iterate through the IEnumerator and display its contents.
while (myCellEnum.MoveNext()) {
current_cell = (TableCell)myCellEnum.Current;
Label1.Text = Label1.Text + " " + current_cell.Text;
}
row_counter++;
}
}
</script>
</head>
<body>
<h3>TableCellCollection Example</h3>
<form runat=server>
<asp:Table id="Table1"
runat="server"/>
<br><br>
<center>
<asp:Button id="Button1"
Text="Copy Table to Array"
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
TableRowCollection-Klasse
TableRowCollection-Member
System.Web.UI.WebControls-Namespace
System.Collections.IEnumerator
TableRow-Klasse
IEnumerator.Current
IEnumerator.MoveNext
IEnumerator.Reset