IEnumerator.Reset メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
列挙子を初期位置、つまりコレクションの最初の要素の前に設定します。
public:
void Reset();
public void Reset ();
abstract member Reset : unit -> unit
Public Sub Reset ()
例外
コレクションは、列挙子の作成後に変更されました。
例
次のコード例は、カスタム コレクションのインターフェイスの IEnumerator 実装を示しています。 この例では、Reset明示的に呼び出されませんが、(for each
Visual 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 との一貫性が保たれます。