Collection.GetEnumerator Yöntem

Tanım

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

public:
 System::Collections::IEnumerator ^ GetEnumerator();
public System.Collections.IEnumerator GetEnumerator ();
member this.GetEnumerator : unit -> System.Collections.IEnumerator
Public Function GetEnumerator () As IEnumerator

Döndürülenler

Koleksiyonda yinelemek için kullanılabilecek bir numaralandırıcı.

Örnekler

Aşağıdaki örnekte, bir Collection nesnenin tüm öğelerini almak için nasıl kullanılacağı GetEnumerator gösterilmektedir.

Dim customers As New Collection
' Insert code to add elements to the customers collection.
Dim custEnum As IEnumerator = customers.GetEnumerator()
custEnum.Reset()
Dim thisCustomer As Object
While custEnum.MoveNext()
    thisCustomer = custEnum.Current()
    ' Insert code to process this element of the collection.
End While

GetEnumeratorad alanının arabirimini System.Collections uygulayan IEnumerator bir numaralandırıcı nesnesi oluşturur ve döndürür. Numaralandırıcı nesnesi özelliğini ve MoveNext ve Reset yöntemlerini kullanıma sunarCurrent. Daha fazla bilgi için bkz. For Each... Next Deyimi.

Açıklamalar

Her İçin... Next Deyimi, bir koleksiyonun öğeleri üzerinde yinelemeyi desteklemek üzere bir numaralandırıcı nesnesi almak için çağırırGetEnumerator. Normalde, bir For Eachkoleksiyon veya diziden geçiş yapmak için bir ...Next döngüsü kullanırsınız ve açıkça çağırmanız GetEnumerator gerekmez.

Yineleme üzerinde ...Next deyimlerinin sağladığından daha For Eachyakın denetime ihtiyacınız varsa, özelleştirilmiş bir dolaşma gerçekleştirmek için yöntemini kullanabilirsinizGetEnumerator. Aşağıda, bunu yapmanız gerekebilecek bazı durumlar yer alır.

  • Koleksiyonun başına dönmek ve yinelemeyi tamamlanmadan önce yeniden başlatmak isteyebilirsiniz.

  • Çeşitli nedenlerle bir veya daha fazla öğeyi atlamak isteyebilirsiniz.

  • Geçişin ortasında koleksiyonun öğelerini değiştirmeniz gerekebilir. Bu durumda, önceki geçersiz kılındığından yeni bir numaralandırıcı nesnesi edinmeniz gerekir.

Şunlara uygulanır