SortedDictionary<TKey,TValue>.KeyCollection.IEnumerable<TKey>.GetEnumerator Yöntem

Tanım

Ad Alanı:

System.Collections.Generic

Bütünleştirilmiş Kod:

System.Collections.dll

Kaynak:

SortedDictionary.cs

Toplulukta yinelenen bir numaralandırıcı döndürür.

 virtual System::Collections::Generic::IEnumerator<TKey> ^ System.Collections.Generic.IEnumerable<TKey>.GetEnumerator() = System::Collections::Generic::IEnumerable<TKey>::GetEnumerator;

System.Collections.Generic.IEnumerator<TKey> IEnumerable<TKey>.GetEnumerator ();

abstract member System.Collections.Generic.IEnumerable<TKey>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<'Key>
override this.System.Collections.Generic.IEnumerable<TKey>.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<'Key>

Function GetEnumerator () As IEnumerator(Of TKey) Implements IEnumerable(Of TKey).GetEnumerator

Döndürülenler

IEnumerator<TKey>

Toplulukta yinelemek için kullanılabilecek bir IEnumerator<T> öğesi.

Uygulamalar

GetEnumerator()

Açıklamalar

foreach C# dilinin deyimi (for eachVisual Basic'te C++For Each'da) numaralandırıcıların karmaşıklığını gizler. Bu nedenle, numaralandırıcıyı doğrudan işlemek yerine kullanılması foreach önerilir.

Numaralandırıcılar, koleksiyonundaki verileri okumak için kullanılabilir, ancak temel koleksiyonu değiştirmek için kullanılamaz.

Başlangıçta, numaralandırıcı, koleksiyondaki ilk öğenin önüne yerleştirilir. Bu konumda özelliği Current tanımlanmamıştır. Bu nedenle, değerini Currentokumadan önce numaralandırıcıyı koleksiyonun ilk öğesine ilerletmek için yöntemini çağırmanız MoveNext gerekir.

Current özelliği çağrılana kadar MoveNext aynı nesneyi döndürür. MoveNext bir sonraki öğeye ayarlar Current .

Koleksiyonun sonunu geçerse MoveNext , numaralandırıcı koleksiyondaki son öğeden sonra konumlandırılır ve MoveNext false döndürür. Numaralandırıcı bu konumda olduğunda, sonraki çağrılar MoveNext da false döndürür. döndürülen falseCurrent son çağrı MoveNext tanımlanmamışsa. Koleksiyonun ilk öğesine yeniden ayarlayamazsınız Current ; bunun yerine yeni bir numaralandırıcı örneği oluşturmanız gerekir.

Bir numaralandırıcı, koleksiyon değişmeden kaldığı sürece geçerli kalır. Koleksiyonda öğe ekleme, değiştirme veya silme gibi değişiklikler yapılırsa, numaralandırıcı geri alınamaz şekilde geçersiz kılınmış olur ve bir sonraki çağrısı MoveNext veya Reset oluşturur InvalidOperationException.

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. Numaralandırma sırasında iş parçacığı güvenliği sağlamak için tüm numaralandırma sırasında koleksiyonu kilitleyebilirsiniz. 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.

Ad alanında System.Collections.Generic koleksiyonların varsayılan uygulamaları eşitlenmez.

Bu yöntem, n'nin bir koleksiyondaki bir dizi öğe olduğu bir O(log n) işlemidir.

Ayrıca bkz.

• IEnumerator<T>