IEnumerator.MoveNext 方法

定义

命名空间:

System.Collections

程序集:

System.Runtime.dll

将枚举数推进到集合的下一个元素。

C#

public bool MoveNext ();

返回

Boolean

如果枚举数已成功地推进到下一个元素，则为 true；如果枚举数传递到集合的末尾，则为 false。

例外

InvalidOperationException

集合在枚举器创建后被修改。

示例

下面的代码示例演示自定义集合接口 IEnumerator 的实现。 在此示例中， MoveNext 未显式调用 ，但实现它以支持在 Visual Basic) 中使用 foreach (for each 。 此代码示例是 接口的较大示例的 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();
            }
        }
    }
}

注解

创建枚举器后或调用 方法后 Reset ，枚举器位于集合的第一个元素之前，对 方法的第一次调用 MoveNext 会将枚举器移到集合的第一个元素上。

如果 MoveNext 传递集合的末尾，则枚举器位于集合中的最后一个元素之后，并 MoveNext 返回 false。 当枚举器位于此位置时，对 的后续调用 MoveNext 也会返回 false ，直到 Reset 调用。

如果对集合进行了更改（例如添加、修改或删除元素），则 的行为 MoveNext 未定义。

适用于

另请参阅

• Current
• Reset()