RepeaterItemCollection.GetEnumerator-Methode

Artikel
08/20/2007

Gibt eine System.Collections.IEnumerator-Schnittstelle zurück, mit der sämtliche RepeaterItem-Objekte in der RepeaterItemCollection durchlaufen werden können.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Function GetEnumerator As IEnumerator
'Usage
Dim instance As RepeaterItemCollection
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

Eine System.Collections.IEnumerator-Schnittstelle, die alle RepeaterItem-Objekte in RepeaterItemCollection enthält.

Hinweise

Erstellen Sie mit dieser Methode einen System.Collections.IEnumerator, mit dem alle Elemente in der RepeaterItemCollection durchlaufen werden können.

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

Eine Darstellung dieses Codes im Kontext eines vollständigen Beispiels finden Sie im Thema zur RepeaterItemCollection-Klasse.

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

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

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

RepeaterItemCollection-Klasse
RepeaterItemCollection-Member
System.Web.UI.WebControls-Namespace
System.Collections.IEnumerator
RepeaterItem-Klasse

Freigeben über