Collection.GetEnumerator Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

Collection.vb

Restituisce un enumeratore che consente di scorrere la raccolta.

public:
 System::Collections::IEnumerator ^ GetEnumerator();

public System.Collections.IEnumerator GetEnumerator ();

member this.GetEnumerator : unit -> System.Collections.IEnumerator

Public Function GetEnumerator () As IEnumerator

Restituisce

IEnumerator

Enumeratore che può essere usato per scorrere la raccolta.

Esempio

Nell'esempio seguente viene illustrato come usare GetEnumerator per recuperare tutti gli elementi di un Collection oggetto.

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

GetEnumerator costruisce e restituisce un oggetto enumeratore, che implementa l'interfaccia IEnumeratorSystem.Collections dello spazio dei nomi. L'oggetto enumeratore espone la Current proprietà e i MoveNext metodi e Reset . Per altre informazioni, vedere For Each... Istruzione successiva.

Commenti

Per ogni... Istruzioni successive chiama GetEnumerator per ottenere un oggetto enumeratore per supportare l'iterazione sugli elementi di una raccolta. In genere, si usa un ciclo ...Next per attraversare una For Eachraccolta o una matrice e non è necessario chiamare GetEnumerator in modo esplicito.

Se è necessario un maggiore controllo sull'iterazione rispetto For Eachalle istruzioni ...Next fornite, è possibile usare il GetEnumerator metodo per eseguire un attraversamento personalizzato. Di seguito sono riportati alcuni casi in cui potrebbe essere necessario eseguire questa operazione.

• È possibile tornare all'inizio della raccolta e avviare nuovamente l'iterazione prima che venga completata.

• È possibile ignorare uno o più elementi per un'ampia gamma di motivi.

• Potrebbe essere necessario modificare gli elementi della raccolta al centro di un attraversamento. In questo caso è necessario ottenere un nuovo oggetto enumeratore perché il precedente è invalidato.