IEnumerator.Current Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera element w kolekcji w bieżącej pozycji modułu wyliczającego.
public:
property System::Object ^ Current { System::Object ^ get(); };
public object Current { get; }
public object? Current { get; }
member this.Current : obj
Public ReadOnly Property Current As Object
Wartość właściwości
Element w kolekcji w bieżącej pozycji modułu wyliczającego.
Przykłady
Poniższy przykład kodu przedstawia implementację IEnumerator interfejsów dla kolekcji niestandardowej. W tym przykładzie Current nie jest jawnie wywoływana, ale jest implementowana w celu obsługi użycia foreach
(for each
w Visual Basic). Ten przykład kodu jest częścią większego przykładu interfejsu IEnumerator .
// When you implement IEnumerable, you must also implement IEnumerator.
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;
}
object IEnumerator.Current
{
get
{
return Current;
}
}
public Person Current
{
get
{
try
{
return _people[position];
}
catch (IndexOutOfRangeException)
{
throw new InvalidOperationException();
}
}
}
}
' When you implement IEnumerable, you must also implement IEnumerator.
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
Uwagi
Current jest niezdefiniowany pod żadnym z następujących warunków:
Moduł wyliczający jest umieszczony przed pierwszym elementem w kolekcji bezpośrednio po utworzeniu modułu wyliczającego. MoveNext musi być wywoływana, aby przejść do pierwszego elementu kolekcji przed odczytaniem wartości Current.
Ostatnie wywołanie zwracane MoveNext
false
, które wskazuje koniec kolekcji.Moduł wyliczający jest unieważniany z powodu zmian wprowadzonych w kolekcji, takich jak dodawanie, modyfikowanie lub usuwanie elementów.
Current zwraca ten sam obiekt do MoveNext momentu wywołania. MoveNext ustawia Current wartość na następny element.