Dictionary<TKey,TValue>.IDictionary.GetEnumerator 메서드

정의

IDictionaryEnumerator 에 대한 IDictionary를 반환합니다.Returns an IDictionaryEnumerator for the IDictionary.

 virtual System::Collections::IDictionaryEnumerator ^ System.Collections.IDictionary.GetEnumerator() = System::Collections::IDictionary::GetEnumerator;
System.Collections.IDictionaryEnumerator IDictionary.GetEnumerator ();
Function GetEnumerator () As IDictionaryEnumerator Implements IDictionary.GetEnumerator

반환

구현

예제

다음 코드 예제에서는 foreach 문 (의 C++For Each Visual Basic의 for each)을 사용 하 여 사전에서 키/값 쌍을 열거 하는 방법을 보여 줍니다 .이는 열거자의 사용을 숨깁니다.The following code example shows how to enumerate the key/value pairs in the dictionary by using the foreach statement (For Each in Visual Basic, for each in C++), which hides the use of the enumerator. 특히 System.Collections.IDictionary 인터페이스의 열거자는 KeyValuePair<TKey,TValue> 개체가 아닌 DictionaryEntry 개체를 반환 합니다.In particular, note that the enumerator for the System.Collections.IDictionary interface returns DictionaryEntry objects rather than KeyValuePair<TKey,TValue> objects.

코드 예제는 IDictionary.Add 메서드에 제공 되는 출력을 포함 하는 더 큰 예제의 일부입니다.The code example is part of a larger example, including output, provided for the IDictionary.Add method.

using System;
using System.Collections;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new dictionary of strings, with string keys,
        // and access it using the IDictionary interface.
        //
        IDictionary openWith = new Dictionary<string, string>();

        // Add some elements to the dictionary. There are no 
        // duplicate keys, but some of the values are duplicates.
        // IDictionary.Add throws an exception if incorrect types
        // are supplied for key or value.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");
Imports System.Collections
Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new dictionary of strings, with string keys,
        ' and access it using the IDictionary interface.
        '
        Dim openWith As IDictionary = _
            New Dictionary(Of String, String)
        
        ' Add some elements to the dictionary. There are no 
        ' duplicate keys, but some of the values are duplicates.
        ' IDictionary.Add throws an exception if incorrect types
        ' are supplied for key or value.
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
// When you use foreach to enumerate dictionary elements
// with the IDictionary interface, the elements are retrieved
// as DictionaryEntry objects instead of KeyValuePair objects.
Console.WriteLine();
foreach( DictionaryEntry de in openWith )
{
    Console.WriteLine("Key = {0}, Value = {1}", 
        de.Key, de.Value);
}
' When you use foreach to enumerate dictionary elements
' with the IDictionary interface, the elements are retrieved
' as DictionaryEntry objects instead of KeyValuePair objects.
Console.WriteLine()
For Each de As DictionaryEntry In openWith
    Console.WriteLine("Key = {0}, Value = {1}", _
        de.Key, de.Value)
Next 
    }
}

    End Sub

End Class

설명

열거의 목적에 맞게 각 항목은 DictionaryEntry 구조입니다.For purposes of enumeration, each item is a DictionaryEntry structure.

C# 언어의 foreach 문 (의 C++for each, Visual Basic의 For Each)은 열거자의 복잡성을 숨깁니다.The foreach statement of the C# language (for each in C++, For Each in Visual Basic) hides the complexity of enumerators. 그러므로 열거자를 직접 조작하는 대신 foreach를 사용하는 것이 좋습니다.Therefore, using foreach is recommended, instead of directly manipulating the enumerator.

열거자를 사용하여 컬렉션의 데이터를 읽을 수는 있지만 내부 컬렉션을 수정할 수는 없습니다.Enumerators can be used to read the data in the collection, but they cannot be used to modify the underlying collection.

처음에 열거자는 컬렉션의 첫 번째 요소 앞에 배치됩니다.Initially, the enumerator is positioned before the first element in the collection. Reset 메서드 또한 다시이 위치로 열거자를 가져옵니다.The Reset method also brings the enumerator back to this position. 이 위치에서 Entry는 정의되지 않습니다.At this position, Entry is undefined. 따라서 호출 해야 합니다 MoveNext 해당 열거자의 값을 읽기 전에 컬렉션의 첫 번째 요소를 이동 하는 방법 Entry합니다.Therefore, you must call the MoveNext method to advance the enumerator to the first element of the collection before reading the value of Entry.

Entry 속성은 MoveNext 또는 Reset 메서드를 호출할 때까지 동일한 요소를 반환 합니다.The Entry property returns the same element until either the MoveNext or Reset method is called. MoveNextEntry를 다음 요소로 설정합니다.MoveNext sets Entry to the next element.

경우 MoveNext 열거자를 컬렉션의 끝 컬렉션의 마지막 요소 뒤에 배치 되는 전달 하 고 MoveNext 반환 false합니다.If MoveNext passes the end of the collection, the enumerator is positioned after the last element in the collection and MoveNext returns false. 열거자가 있는 경우이 위치에 대 한 후속 호출은 MoveNext 반환할 수도 false합니다.When the enumerator is at this position, subsequent calls to MoveNext also return false. MoveNext에 대 한 마지막 호출이 false를 반환 하는 경우 Entry이 정의 되지 않습니다.If the last call to MoveNext returned false, Entry is undefined. Entry를 컬렉션의 첫째 요소에 다시 설정하려면 Reset을 호출한 뒤 MoveNext를 호출해야 합니다.To set Entry to the first element of the collection again, you can call Reset followed by MoveNext.

열거자는 컬렉션이 변경되지 않은 상태로 유지되는 한 유효한 상태를 유지합니다.An enumerator remains valid as long as the collection remains unchanged. 요소를 추가 하거나 용량을 변경 하는 등 컬렉션을 변경 하면 열거자가 복구할 수 없게 무효화 되 고 MoveNext 또는 IEnumerator.Reset에 대 한 다음 호출이 InvalidOperationException을 throw 합니다.If changes are made to the collection, such as adding elements or changing the capacity, the enumerator is irrecoverably invalidated and the next call to MoveNext or IEnumerator.Reset throws an InvalidOperationException.

.NET Core 3.0 +만 해당: 열거자를 무효화 하지 않는 유일한 변경 방법은 Remove 하 고 Clear합니다..NET Core 3.0+ only: The only mutating methods which do not invalidate enumerators are Remove and Clear.

열거자는 컬렉션에 배타적으로 액세스하지 못하므로 컬렉션을 열거하는 것은 본질적으로 스레드로부터 안전한 프로시저가 아닙니다.The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure. 열거 동안 스레드 보안을 보장하려면 전체 열거 동안 컬렉션을 잠그면 됩니다.To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. 여러 스레드에서 컬렉션에 액세스하여 읽고 쓸 수 있도록 허용하려면 사용자 지정 동기화를 구현해야 합니다.To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization.

System.Collections.Generic 네임스페이스에서 컬렉션의 기본 구현은 동기화되지 않습니다.Default implementations of collections in the System.Collections.Generic namespace are not synchronized.

이 방법은 O(1) 작업에 설명 합니다.This method is an O(1) operation.

적용 대상

추가 정보