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 scorre l'insieme.
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 utilizzare 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 IEnumerator dello spazio dei System.Collections nomi . L'oggetto enumeratore espone la Current proprietà e i MoveNext metodi e Reset . Per ulteriori informazioni, vedere For Each...Next.
Commenti
La for each... Next Statement chiama GetEnumerator per ottenere un oggetto enumeratore per supportare l'iterazione sugli elementi di una raccolta. In genere, si usa un For Eachciclo ...Next per attraversare una raccolta 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 di nuovo l'iterazione prima che venga completata.
È possibile ignorare uno o più elementi per diversi motivi.
Potrebbe essere necessario modificare gli elementi della raccolta al centro di un attraversamento. In questo caso è necessario ottenere un nuovo oggetto enumeratore perché quello precedente è invalidato.
