IEnumerator.Current Proprietà

Definizione

Ottiene l'elemento della raccolta in corrispondenza della posizione corrente dell'enumeratore.

C#
public object Current { get; }
C#
public object? Current { get; }

Valore della proprietà

Elemento della raccolta in corrispondenza della posizione corrente dell'enumeratore.

Esempio

Nell'esempio di codice seguente viene illustrata l'implementazione delle IEnumerator interfacce per una raccolta personalizzata. In questo esempio non Current viene chiamato in modo esplicito, ma viene implementato per supportare l'uso di foreach (for each in Visual Basic). Questo esempio di codice fa parte di un esempio più grande per l'interfaccia IEnumerator .

C#
// 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();
            }
        }
    }
}

Commenti

Current non è definito in una delle condizioni seguenti:

  • L'enumeratore viene posizionato prima del primo elemento della raccolta, immediatamente dopo la creazione dell'enumeratore. MoveNext deve essere chiamato per avanzare l'enumeratore al primo elemento della raccolta prima di leggere il valore di Current.

  • L'ultima chiamata a MoveNext restituita false, che indica la fine della raccolta.

  • L'enumeratore non è valido a causa delle modifiche apportate all'insieme, ad esempio l'aggiunta, la modifica o l'eliminazione di elementi.

La proprietà Current restituisce lo stesso oggetto finché non viene chiamato il metodo MoveNext. MoveNext imposta Current sull'elemento successivo.

Si applica a

Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Vedi anche