GradientStopCollection.GetEnumerator Yöntem

Tanım

Ad Alanı:

System.Windows.Media

Bütünleştirilmiş Kod:

PresentationCore.dll

Koleksiyonda yinelenebilen bir listeleyici döndürür.

public:
 System::Windows::Media::GradientStopCollection::Enumerator GetEnumerator();

public System.Windows.Media.GradientStopCollection.Enumerator GetEnumerator ();

member this.GetEnumerator : unit -> System.Windows.Media.GradientStopCollection.Enumerator

Public Function GetEnumerator () As GradientStopCollection.Enumerator

Döndürülenler

GradientStopCollection.Enumerator

GradientStopCollection.Enumerator Koleksiyonda yinelenebilir.

Açıklamalar

Numaralandırıcılar yalnızca koleksiyondaki verilerin okunmasına izin verir. Numaralandırıcılar, temel alınan koleksiyonu değiştirmek için kullanılamaz.

Başlangıçta, numaralandırıcı koleksiyondaki ilk öğeden önce konumlandırılır. ayrıca numaralandırıcıyı bu konuma geri getirir. Bu konumda çağrısı Current bir özel durum oluşturur. Bu nedenle, değerini Currentokumadan önce numaralandırıcıyı koleksiyonun ilk öğesine ilerletmek için çağrısında MoveNext bulunmalısınız.

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

Koleksiyonun sonu geçirildikten sonra, numaralandırıcı koleksiyondaki son öğeden sonra konumlandırılır ve çağrısı MoveNext döndürür false. döndürülen falseson çağrı MoveNext ise, çağrısı Current bir özel durum oluşturur. Koleksiyonun ilk öğesine yeniden ayarlamak Current için öğesini ve ardından MoveNextöğesini çağırabilirsinizReset.

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ı veya MoveNext Reset oluşturur InvalidOperationException. Koleksiyon ile CurrentCurrent arasında MoveNext değiştirilirse, numaralandırıcı zaten geçersiz kılınmış olsa bile, ayarlandığı öğeyi döndürür.

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. Bir koleksiyon eşitlendiğinde bile, diğer iş parçacıkları koleksiyonu yine de değiştirebilir ve bu da numaralandırıcının özel durum oluşturmasına neden olur. Numaralandırma sırasında iş parçacığı güvenliği sağlamak için tüm numaralandırma sırasında koleksiyonu kilitleyebilir veya diğer iş parçacıkları tarafından yapılan değişikliklerden kaynaklanan özel durumları yakalayabilirsiniz.