ListItemCollection.GetEnumerator Method
Returns a System.Collections.IEnumerator implemented object that contains all ListItem objects in the ListItemCollection.
[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 ListItem objects in the ListItemCollection.
Implements
Remarks
Use this method to create a System.Collections.IEnumerator that can be iterated through to get each ListItem object in the ListItemCollection.
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] Sub AllItems_Click(sender As Object, e As EventArgs) Dim dataListEnumerator As IEnumerator Dim currentItem As DataListItem lblAllItems.Text = "" ' Get an enumerator to traverse the DataListItemCollection. dataListEnumerator = myDataList.Items.GetEnumerator() while(dataListEnumerator.MoveNext()) currentItem = CType(dataListEnumerator.Current,DataListItem) ' Display the current DataListItem onto the label. lblAllItems.Text = lblAllItems.Text & CType((currentItem.Controls(1)),Label).Text & " " End While End Sub [C#] void allItems_Click(Object sender,EventArgs e) { IEnumerator dataListEnumerator; DataListItem currentItem; lblAllItems.Text = ""; // Get an enumerator to traverse the DataListItemCollection. dataListEnumerator = myDataList.Items.GetEnumerator(); while(dataListEnumerator.MoveNext()) { currentItem = (DataListItem)dataListEnumerator.Current; // Display the current DataListItem onto the label. lblAllItems.Text += ((Label)(currentItem.Controls[1])).Text + " "; } }
[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
ListItemCollection Class | ListItemCollection Members | System.Web.UI.WebControls Namespace | IEnumerable | IEnumerator.Reset | IEnumerator.MoveNext | IEnumerator.Current