IEnumerator.Current-Eigenschaft

Ruft das aktuelle Element in der Auflistung ab.

Namespace: System.Collections
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
ReadOnly Property Current As Object
'Usage
Dim instance As IEnumerator
Dim value As Object

value = instance.Current

Object Current { get; }

property Object^ Current {
    Object^ get ();
}

/** @property */
Object get_Current ()

function get Current () : Object

Eigenschaftenwert

Das aktuelle Element in der Auflistung.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Der Enumerator ist vor dem ersten Element oder hinter dem letzten Element der Auflistung positioniert. – oder – Die Auflistung wurde nach dem Erstellen des Enumerators geändert.

Hinweise

Nach dem Erstellen eines Enumerators oder nach dem Aufrufen der Reset-Methode muss die MoveNext-Methode aufgerufen werden, um den Enumerator vor dem Lesen des Werts der Current-Eigenschaft auf das erste Element der Auflistung festzulegen. Andernfalls ist Current nicht definiert.

Außerdem löst Current eine Ausnahme aus, wenn beim letzten Aufruf von MoveNextfalse zurückgegeben wurde, wodurch das Ende der Auflistung angegeben wird.

Current ändert die Position des Enumerators nicht. Nachfolgende Aufrufe von Current geben daher dasselbe Objekt zurück, bis entweder MoveNext oder Reset aufgerufen wird.

Ein Enumerator bleibt so lange gültig, bis die Auflistung geändert wird. Wenn an der Auflistung Änderungen vorgenommen werden, z. B. durch Hinzufügen, Ändern oder Entfernen von Elementen, ist der Enumerator unwiderruflich ungültig, und der nächste Aufruf von MoveNext oder Reset löst eine InvalidOperationException aus. Wenn die Auflistung zwischen MoveNext und Current geändert wird, gibt Current das Element zurück, auf das der Enumerator festgelegt wurde, auch wenn er bereits ungültig ist.

Beispiel

Im folgenden Codebeispiel wird die Implementierung von IEnumerator-Schnittstellen für eine benutzerdefinierte Auflistung veranschaulicht. In diesem Beispiel wird Current nicht explizit aufgerufen, sondern es wird zur Unterstützung der Verwendung von foreach (for each in Visual Basic) implementiert. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die IEnumerator-Schnittstelle.

Public Class PeopleEnum
    Implements IEnumerator

    Public _people() As Person

    ' Enumerators are positioned before the first element
    ' until the first MoveNext() call.
    Dim position As Integer = -1

    Public Sub New(ByVal list() As Person)
        _people = list
    End Sub

    Public Function MoveNext() As Boolean Implements IEnumerator.MoveNext
        position = position + 1
        Return (position < _people.Length)
    End Function

    Public Sub Reset() Implements IEnumerator.Reset
        position = -1
    End Sub

    Public ReadOnly Property Current() As Object Implements IEnumerator.Current
        Get
            Try
                Return _people(position)
            Catch ex As IndexOutOfRangeException
                Throw New InvalidOperationException()
            End Try
        End Get
    End Property
End Class

public class PeopleEnum : IEnumerator
{
    public Person[] _people;

    // Enumerators are positioned before the first element
    // until the first MoveNext() call.
    int position = -1;

    public PeopleEnum(Person[] list)
    {
        _people = list;
    }

    public bool MoveNext()
    {
        position++;
        return (position < _people.Length);
    }

    public void Reset()
    {
        position = -1;
    }

    public object Current
    {
        get
        {
            try
            {
                return _people[position];
            }
            catch (IndexOutOfRangeException)
            {
                throw new InvalidOperationException();
            }
        }
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IEnumerator-Schnittstelle
IEnumerator-Member
System.Collections-Namespace
MoveNext
Reset