IEnumerator 인터페이스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
제네릭이 아닌 컬렉션에 대한 간단한 반복을 지원합니다.
public interface class IEnumeratorpublic interface IEnumerator[System.Runtime.InteropServices.Guid("496B0ABF-CDEE-11d3-88E8-00902754C43A")]
public interface IEnumerator[System.Runtime.InteropServices.Guid("496B0ABF-CDEE-11d3-88E8-00902754C43A")]
[System.Runtime.InteropServices.ComVisible(true)]
public interface IEnumeratortype IEnumerator = interface[<System.Runtime.InteropServices.Guid("496B0ABF-CDEE-11d3-88E8-00902754C43A")>]
type IEnumerator = interface[<System.Runtime.InteropServices.Guid("496B0ABF-CDEE-11d3-88E8-00902754C43A")>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type IEnumerator = interfacePublic Interface IEnumerator- 파생
- 특성
예제
다음 코드 예제에서는 사용자 지정 컬렉션에 대 한 IEnumerable 및 IEnumerator 인터페이스의 구현을 보여 줍니다. 이 예제에서 이러한 인터페이스의 멤버는 명시적으로 호출되지 않지만 컬렉션을 반복하기 위해 foreach(Visual Basic의for each)를 사용하도록 지원하도록 구현됩니다.
using System;
using System.Collections;
// Simple business object.
public class Person
{
public Person(string fName, string lName)
{
this.firstName = fName;
this.lastName = lName;
}
public string firstName;
public string lastName;
}
// Collection of Person objects. This class
// implements IEnumerable so that it can be used
// with ForEach syntax.
public class People : IEnumerable
{
private Person[] _people;
public People(Person[] pArray)
{
_people = new Person[pArray.Length];
for (int i = 0; i < pArray.Length; i++)
{
_people[i] = pArray[i];
}
}
// Implementation for the GetEnumerator method.
IEnumerator IEnumerable.GetEnumerator()
{
return (IEnumerator) GetEnumerator();
}
public PeopleEnum GetEnumerator()
{
return new PeopleEnum(_people);
}
}
// 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();
}
}
}
}
class App
{
static void Main()
{
Person[] peopleArray = new Person[3]
{
new Person("John", "Smith"),
new Person("Jim", "Johnson"),
new Person("Sue", "Rabon"),
};
People peopleList = new People(peopleArray);
foreach (Person p in peopleList)
Console.WriteLine(p.firstName + " " + p.lastName);
}
}
/* This code produces output similar to the following:
*
* John Smith
* Jim Johnson
* Sue Rabon
*
*/
Imports System.Collections
' Simple business object.
Public Class Person
Public Sub New(ByVal fName As String, ByVal lName As String)
Me.firstName = fName
Me.lastName = lName
End Sub
Public firstName As String
Public lastName As String
End Class
' Collection of Person objects, which implements IEnumerable so that
' it can be used with ForEach syntax.
Public Class People
Implements IEnumerable
Private _people() As Person
Public Sub New(ByVal pArray() As Person)
_people = New Person(pArray.Length - 1) {}
Dim i As Integer
For i = 0 To pArray.Length - 1
_people(i) = pArray(i)
Next i
End Sub
' Implementation of GetEnumerator.
Public Function GetEnumerator() As IEnumerator _
Implements IEnumerable.GetEnumerator
Return New PeopleEnum(_people)
End Function
End Class
' 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
Class App
Shared Sub Main()
Dim peopleArray() As Person = { _
New Person("John", "Smith"), _
New Person("Jim", "Johnson"), _
New Person("Sue", "Rabon")}
Dim peopleList As New People(peopleArray)
Dim p As Person
For Each p In peopleList
Console.WriteLine(p.firstName + " " + p.lastName)
Next
End Sub
End Class
' This code produces output similar to the following:
'
' John Smith
' Jim Johnson
' Sue Rabon
설명
IEnumerator 제네릭이 아닌 모든 열거자의 기본 인터페이스입니다. 해당 제네릭은 System.Collections.Generic.IEnumerator<T> 인터페이스입니다.
C# 언어의 foreach 문(Visual Basic의for each)은 열거자의 복잡성을 숨깁니다. 따라서 열거자를 직접 조작하는 대신 foreach 사용하는 것이 좋습니다.
열거자는 컬렉션의 데이터를 읽는 데 사용할 수 있지만 기본 컬렉션을 수정하는 데 사용할 수는 없습니다.
Reset 메서드는 COM 상호 운용성을 위해 제공되며 완전히 구현될 필요는 없습니다. 대신 구현자는 NotSupportedExceptionthrow할 수 있습니다.
처음에는 열거자가 컬렉션의 첫 번째 요소 앞에 배치됩니다. 의 값을 읽기 전에 열거자를 컬렉션의 첫 번째 요소로 이동하려면 MoveNext 메서드를 호출해야 Current합니다. 그렇지 않으면 Current 정의되지 않습니다.
Current MoveNext 또는 Reset 호출될 때까지 동일한 개체를 반환합니다. MoveNext Current 다음 요소로 설정합니다.
MoveNext 컬렉션의 끝을 통과하면 열거자가 컬렉션의 마지막 요소 다음 위치에 배치되고 MoveNextfalse반환합니다. 열거자가 이 위치에 있으면 MoveNext 대한 후속 호출도 false반환합니다.
MoveNext 마지막 호출이 false반환되면 Current 정의되지 않습니다.
Current 컬렉션의 첫 번째 요소로 다시 설정하려면 Reset(구현된 경우) 뒤에 MoveNext호출할 수 있습니다. Reset 구현되지 않은 경우 컬렉션의 첫 번째 요소로 돌아갈 새 열거자 인스턴스를 만들어야 합니다.
요소 추가, 수정 또는 삭제와 같이 컬렉션이 변경되면 열거자의 동작이 정의되지 않습니다.
열거자는 컬렉션에 대한 단독 액세스 권한이 없습니다. 따라서 컬렉션을 열거하는 것은 본질적으로 스레드로부터 안전한 프로시저가 아닙니다. 컬렉션이 동기화된 경우에도 다른 스레드는 컬렉션을 수정할 수 있으므로 열거자가 예외를 throw합니다. 열거 중 스레드 안전을 보장하기 위해 전체 열거 중에 컬렉션을 잠그거나 다른 스레드의 변경으로 인한 예외를 catch할 수 있습니다.
속성
| Current |
열거자의 현재 위치에 있는 컬렉션의 요소를 가져옵니다. |
메서드
| MoveNext() |
열거자를 컬렉션의 다음 요소로 진행합니다. |
| Reset() |
열거자를 컬렉션의 첫 번째 요소 앞에 있는 초기 위치로 설정합니다. |
적용 대상
추가 정보
.NET