Export (0) Print
Expand All

RepeaterItemCollection.GetEnumerator Method

Returns a System.Collections.IEnumerator interface that contains all RepeaterItem objects in the RepeaterItemCollection.

[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 interface that contains all RepeaterItem objects in the RepeaterItemCollection.

Implements

IEnumerable.GetEnumerator

Remarks

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

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   After you create a System.Collections.IEnumerator object or use the IEnumerator.Reset method to move the enumerator to the first item in the collection, you must call the IEnumerator.MoveNext method. Otherwise, the item represented by the IEnumerator.Current property is undefined.

Example

[Visual Basic] 
<!-- 
To see this snippet in the context of a complete example,
see the RepeaterItemCollection class topic.
-->
    . . . 
         Sub GetEnumerator_Clicked(Sender As [Object], e As EventArgs)
            labelDisplay.Text = "Invoking GetEnumerator method.<br>"
            labelDisplay.Text += "The Items collection contains: <br>"
            
            ' Display the elements of the RepeaterItemCollection using GetEnumerator.
            Dim myItemCollection As RepeaterItemCollection = myRepeater.Items
            Dim myEnumertor As IEnumerator = myItemCollection.GetEnumerator()
            While myEnumertor.MoveNext()
               Dim myItem As RepeaterItem = CType(myEnumertor.Current, RepeaterItem)
               labelDisplay.Text += CType(myItem.Controls(0), DataBoundLiteralControl).Text + "<br>"
            End While
         End Sub 'GetEnumerator_Clicked

[C#] 
<!-- 
To see this snippet in the context of a complete example,
see the RepeaterItemCollection class topic.
-->
    . . . 
      void GetEnumerator_Clicked(Object Sender, EventArgs e)
      {
         labelDisplay.Text = "Invoking GetEnumerator method.<br>";
         labelDisplay.Text += "The Items collection contains: <br>";

         // Display the elements of the RepeaterItemCollection using GetEnumerator.
         RepeaterItemCollection  myItemCollection = myRepeater.Items;
         IEnumerator myEnumertor = myItemCollection.GetEnumerator();
         while(myEnumertor.MoveNext())
         {
            RepeaterItem myItem = (RepeaterItem)myEnumertor.Current;
            labelDisplay.Text += ((DataBoundLiteralControl)
               myItem.Controls[0]).Text + "<br>";
         }
      }

[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

RepeaterItemCollection Class | RepeaterItemCollection Members | System.Web.UI.WebControls Namespace | System.Collections.IEnumerator | RepeaterItem

Show:
© 2014 Microsoft