Dictionary<TKey,TValue>.IDictionary.GetEnumerator Yöntem

Tanım

İçin bir döndürür 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 ();
abstract member System.Collections.IDictionary.GetEnumerator : unit -> System.Collections.IDictionaryEnumerator
override this.System.Collections.IDictionary.GetEnumerator : unit -> System.Collections.IDictionaryEnumerator
Function GetEnumerator () As IDictionaryEnumerator Implements IDictionary.GetEnumerator

Döndürülenler

IDictionaryEnumerator

IDictionaryEnumeratorİçin bir IDictionary .An IDictionaryEnumerator for the IDictionary.

Uygulamalar

Örnekler

Aşağıdaki kod örneği, foreach For Each for each Numaralandırıcı kullanımını gizleyen, (C++ ' ta Visual Basic) ifadesini kullanarak Sözlükteki anahtar/değer çiftlerinin nasıl numaralandırılacağını gösterir.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. Özellikle, arabirim için numaralandırıcı System.Collections.IDictionary DictionaryEntry nesneler yerine nesneleri döndürdüğünü unutmayın KeyValuePair<TKey,TValue> .In particular, note that the enumerator for the System.Collections.IDictionary interface returns DictionaryEntry objects rather than KeyValuePair<TKey,TValue> objects.

Kod örneği, yöntemi için sağlanmış olan output dahil daha büyük bir örneğin bir parçasıdır 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

Açıklamalar

Sabit Listesi amaçları için her öğe bir DictionaryEntry yapıdır.For purposes of enumeration, each item is a DictionaryEntry structure.

foreachC# dilinin ( for each For Each Visual Basic içindeki C++) deyimleri, numaralandırıcıların karmaşıklığını gizler.The foreach statement of the C# language (for each in C++, For Each in Visual Basic) hides the complexity of enumerators. Bu nedenle, foreach Numaralandırıcının doğrudan düzenlenmesi yerine kullanılması önerilir.Therefore, using foreach is recommended, instead of directly manipulating the enumerator.

Numaralandırıcılar, koleksiyonundaki verileri okumak için kullanılabilir, ancak temel koleksiyonu değiştirmek için kullanılamaz.Enumerators can be used to read the data in the collection, but they cannot be used to modify the underlying collection.

Başlangıçta, numaralandırıcı, koleksiyondaki ilk öğenin önüne yerleştirilir.Initially, the enumerator is positioned before the first element in the collection. ResetYöntemi Ayrıca, numaralandırıcısı bu konuma geri getirir.The Reset method also brings the enumerator back to this position. Bu konumda Entry tanımsız.At this position, Entry is undefined. Bu nedenle, MoveNext değerini okumadan önce sayacı koleksiyonun ilk öğesine ilerletmek için yöntemini çağırmanız gerekir 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Özelliği MoveNext ya da Reset yöntemi çağrılana kadar aynı öğeyi döndürür.The Entry property returns the same element until either the MoveNext or Reset method is called. MoveNext bir Entry sonraki öğeye ayarlar.MoveNext sets Entry to the next element.

MoveNextKoleksiyonun sonunu geçerse, Numaralandırıcı koleksiyondaki son öğeden sonra konumlandırılır ve MoveNext döndürür false .If MoveNext passes the end of the collection, the enumerator is positioned after the last element in the collection and MoveNext returns false. Numaralandırıcı bu konumda olduğunda, sonraki çağrılar MoveNext de döndürülür false .When the enumerator is at this position, subsequent calls to MoveNext also return false. Döndürülen son çağrı MoveNext false Entry tanımsızdır.If the last call to MoveNext returned false, Entry is undefined. EntryKoleksiyonun ilk öğesine yeniden ayarlamak için, ardından öğesini çağırabilirsiniz Reset MoveNext .To set Entry to the first element of the collection again, you can call Reset followed by MoveNext.

Bir numaralandırıcı, koleksiyon değişmeden kaldığı sürece geçerli kalır.An enumerator remains valid as long as the collection remains unchanged. Koleksiyonda değişiklik yapılırsa (örneğin, öğe ekleme veya kapasiteyi değiştirme), Numaralandırıcı ırrecoverdüzensiz olarak geçersiz kılınır ve bir sonraki çağrısı MoveNext veya IEnumerator.Reset atar InvalidOperationException .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.

Yalnızca .NET Core 3.0 +: Numaralandırıcı olmayan tek değiştirici Yöntemler Remove ve ' dir Clear ..NET Core 3.0+ only: The only mutating methods which do not invalidate enumerators are Remove and Clear.

Numaralandırıcının, koleksiyona özel kullanım erişimi yok; bu nedenle, bir koleksiyon içinde numaralandırma aslında bir iş parçacığı açısından güvenli yordam değildir.The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure. Numaralandırma sırasında iş parçacığı güvenliği sağlamak için tüm numaralandırma sırasında koleksiyonu kilitleyebilirsiniz.To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. Okuma ve yazma için birden çok iş parçacığı tarafından erişilecek koleksiyona izin vermek için kendi eşitlemenizi uygulamalısınız.To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization.

Ad alanındaki koleksiyonların varsayılan uygulamaları System.Collections.Generic eşitlenmez.Default implementations of collections in the System.Collections.Generic namespace are not synchronized.

Bu yöntem bir O(1) işlemidir.This method is an O(1) operation.

Şunlara uygulanır

Ayrıca bkz.