IEnumerator.Reset メソッド

定義

名前空間:

System.Collections

アセンブリ:

System.Runtime.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

列挙子を初期位置、つまりコレクションの最初の要素の前に設定します。

public:
 void Reset();

public void Reset ();

abstract member Reset : unit -> unit

Public Sub Reset ()

例外

InvalidOperationException

コレクションは、列挙子の作成後に変更されました。

例

次のコード例は、カスタム コレクションのインターフェイスの IEnumerator 実装を示しています。 この例では、Reset明示的に呼び出されませんが、(for eachVisual Basic) のforeach使用をサポートするように実装されています。 このコード例は、インターフェイスのより大きな例の 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

注釈

要素の追加、変更、削除など、コレクションに変更が加えられた場合、その Reset 動作は未定義です。

このメソッドは Reset 、COM の相互運用性のために提供されます。 必ずしも実装する必要はありません。代わりに、実装者は単に .NotSupportedException

注意 (実装者)

Reset() を呼び出した結果は、列挙子にとって常に同じ状態になる必要があります。 列挙子をコレクションの先頭、つまり先頭の要素の前に移動するような実装を推奨します。 そうすると、列挙子の作成後にコレクションが変更されていた場合は列挙子が無効になり、MoveNext() および Current との一貫性が保たれます。

こちらもご覧ください

• MoveNext()
• Current