TableRowCollection.GetEnumerator Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna um objeto implementado IEnumerator que contém todos os objetos TableRow no TableRowCollection.
public:
virtual System::Collections::IEnumerator ^ GetEnumerator();public System.Collections.IEnumerator GetEnumerator ();abstract member GetEnumerator : unit -> System.Collections.IEnumerator
override this.GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorRetornos
Um objeto implementado IEnumerator que contém todos os objetos TableRow no TableRowCollection.
Implementações
Exemplos
O exemplo a seguir demonstra como usar o GetEnumerator método para criar um System.Collections.IEnumerator objeto implementado que é iterado para exibir os itens na tabela.
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Text" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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 rowNum = 0; rowNum < numRows; rowNum++)
{
TableRow rw = new TableRow();
for (int cellNum = 0; cellNum < numCells; cellNum++)
{
TableCell cel = new TableCell();
cel.Text = counter.ToString();
rw.Cells.Add(cel);
counter++;
}
Table1.Rows.Add(rw);
}
}
void Button_Click(object sender, EventArgs e)
{
int rowCounter = 0;
TableCell currentCell;
StringBuilder tb = new StringBuilder();
// Create an IEnumerator for the rows of a table.
IEnumerator myRowEnum = Table1.Rows.GetEnumerator();
tb.Append("The copied items from the table are: <br />");
// Iterate through the IEnumerator and display its contents.
while (myRowEnum.MoveNext())
{
// Create an IEnumerator for the cells of the row.
IEnumerator myCellEnum = Table1.Rows[rowCounter].Cells.GetEnumerator();
// Iterate through the IEnumerator and display its contents.
while (myCellEnum.MoveNext())
{
currentCell = (TableCell)myCellEnum.Current;
tb.Append(currentCell.Text + ", ");
}
rowCounter++;
}
Label1.Text = tb.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>TableCellCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TableCellCollection Example</h3>
<asp:Table id="Table1" runat="server"/>
<br /> <br />
<asp:Button id="Button1"
Text="Copy Table to Array"
OnClick="Button_Click"
runat="server"/>
<br /> <br />
<asp:Label id="Label1" runat="server"/>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Text" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Page_Load(ByVal sender As Object, ByVal 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 rowNum As Integer
For rowNum = 0 To numrows - 1
Dim rw As New TableRow()
Dim cellNum As Integer
For cellNum = 0 To numcells - 1
Dim cel As New TableCell()
cel.Text = counter.ToString()
rw.Cells.Add(cel)
counter += 1
Next cellNum
Table1.Rows.Add(rw)
Next rowNum
End Sub
Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim rowCounter As Integer = 0
Dim currentCell As TableCell
Dim tb As New StringBuilder
' Create an IEnumerator for the rows of the table.
Dim myRowEnum As IEnumerator = Table1.Rows.GetEnumerator()
tb.Append("The copied items from the table are: <br />")
' 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(rowCounter).Cells.GetEnumerator()
' Iterate through the IEnumerator and display its contents.
While myCellEnum.MoveNext()
currentCell = CType(myCellEnum.Current, TableCell)
tb.Append(currentCell.Text & ", ")
End While
Label1.Text = tb.ToString()
rowCounter += 1
End While
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>TableCellCollection Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TableCellCollection Example</h3>
<asp:Table id="Table1" runat="server" />
<br /> <br />
<asp:Button id="Button1"
Text="Copy Table to Array"
OnClick="Button_Click"
runat="server"/>
<br /> <br />
<asp:Label id="Label1" runat="server" />
</div>
</form>
</body>
</html>
Comentários
Use esse método para criar um System.Collections.IEnumerator objeto implementado que pode ser iterado facilmente para obter cada item no TableRowCollection.
Use a IEnumerator.Current propriedade para obter o item apontado atualmente na coleção.
Use o IEnumerator.MoveNext método para mover para o próximo item na coleção.
Use o IEnumerator.Reset método para mover o enumerador de volta para a posição inicial.
Observação
O IEnumerator.MoveNext método deve ser chamado depois de criar um System.Collections.IEnumerator objeto implementado ou usar o IEnumerator.Reset método para mover o enumerador para o primeiro item da coleção. Caso contrário, o item representado pela IEnumerator.Current propriedade é indefinido.
