ListItemCollection.GetEnumerator-Methode

Artikel
08/20/2007

Gibt ein implementiertes System.Collections.IEnumerator-Objekt zurück, das alle ListItem-Objekte in ListItemCollection 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 ListItemCollection
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, das alle ListItem-Objekte in der ListItemCollection enthält.

Hinweise

Mit dieser Methode erstellen Sie einen System.Collections.IEnumerator, der durchlaufen werden kann, um jedes ListItem-Objekt in ListItemCollection abzurufen.

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 System.Collections.IEnumerator-Objekt erstellt oder die IEnumerator.Reset-Methode verwendet wurde, mit der der Enumerator zum ersten Element in der Auflistung verschoben wird. Andernfalls ist das durch die IEnumerator.Current-Eigenschaft dargestellte Element nicht definiert.

Beispiel

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

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 + " ";
    }
}

void AllItems_Click(Object sender, EventArgs e)
{
    IEnumerator dataListEnumerator;
    DataListItem currentItem;
    lblAllItems.set_Text("");
    
    // Get an enumerator to traverse the DataListItemCollection.
    dataListEnumerator = myDataList.get_Items().GetEnumerator();
    while(dataListEnumerator.MoveNext()) {
        currentItem =((DataListItem)(dataListEnumerator.get_Current()));
        // Display the current DataListItem onto the label.
        lblAllItems.set_Text(lblAllItems.get_Text() 
            +((Label)(currentItem.get_Controls() .get_Item( 1))).get_Text() 
            + " ");
    }
} //AllItems_Click

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

ListItemCollection-Klasse
ListItemCollection-Member
System.Web.UI.WebControls-Namespace
IEnumerable
IEnumerator.Reset
IEnumerator.MoveNext
IEnumerator.Current

Freigeben über