Collection.GetEnumerator Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.IEnumeratorPublic Function GetEnumerator () As IEnumeratorRestituisce
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.
