This documentation is archived and is not being maintained.

TableCellCollection.GetEnumerator Method

Returns a System.Collections.IEnumerator implemented object that contains all TableCell objects in the TableCellCollection.

[Visual Basic]
Public Overridable Function GetEnumerator() As IEnumerator _
   Implements IEnumerable.GetEnumerator
[C#]
public virtual IEnumerator GetEnumerator();
[C++]
public: virtual IEnumerator* GetEnumerator();
[JScript]
public function GetEnumerator() : IEnumerator;

Return Value

A System.Collections.IEnumerator implemented object that contains all TableCell objects within the TableCellCollection.

Implements

IEnumerable.GetEnumerator

Remarks

Use this method to create a System.Collections.IEnumerator implemented object that can be iterated through easily to get each item in the TableCellCollection.

Use the IEnumerator.Current property to get the item currently pointed to in the collection.

Use the IEnumerator.MoveNext method to move to the next item in the collection.

Use the IEnumerator.Reset method to move the enumerator back to the initial position.

Note   The IEnumerator.MoveNext method must be called after creating a System.Collections.IEnumerator implemented object or after using the IEnumerator.Reset method to move the enumerator to the first item in the collection. Otherwise, the item represented by the IEnumerator.Current property is undefined.

Example

[Visual Basic, C#] The following example demonstrates how to use the GetEnumerator method to create a System.Collections.IEnumerator implemented object. It is then iterated through to display the items in the selected row.

[Visual Basic] 
<%@ 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>
 

[C#] 
<%@ 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>
 

[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family

See Also

TableCellCollection Class | TableCellCollection Members | System.Web.UI.WebControls Namespace | System.Collections.IEnumerator | TableCell | IEnumerator.Current | IEnumerator.MoveNext | IEnumerator.Reset

Show: