Metodo GetEnumerator (oggetto Collection)
Aggiornamento: novembre 2007
Restituisce un riferimento a un oggetto enumeratore utilizzato per scorrere un Oggetto Collection (Visual Basic).
Public Function GetEnumerator() As IEnumerator
Note
Istruzione For Each...Next (Visual Basic) chiama GetEnumerator per ottenere un oggetto enumeratore che supporti lo scorrimento degli elementi di un insieme. Generalmente, si utilizza un ciclo For Each...Next per scorrere un insieme o una matrice e non è necessario chiamare GetEnumerator in modo esplicito.
Per ottenere un maggiore controllo sull'iterazione rispetto a quello fornito dalle istruzioni For Each...Next, è possibile utilizzare il metodo GetEnumerator per eseguire uno scorrimento personalizzato. Di seguito sono riportati alcuni casi in cui è necessario procedere in questo modo.
È necessario tornare all'inizio dell'insieme e riavviare l'iterazione prima che termini.
È necessario ignorare uno o più elementi per diversi motivi.
È necessario modificare gli elementi dell'insieme durante uno scorrimento. In questo caso è necessario ottenere un nuovo oggetto enumeratore in quanto quello precedente viene invalidato.
Esempio
Nell'esempio seguente viene illustrato come utilizzare GetEnumerator per recuperare tutti gli elementi di un oggetto Collection.
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 crea e restituisce un oggetto enumeratore che implementa l'interfaccia IEnumerator dello spazio dei nomi System.Collections. L'oggetto enumeratore espone la proprietà Current e i metodi MoveNext e Reset. Per ulteriori informazioni, vedere Istruzione For Each...Next (Visual Basic).
Requisiti
Spazio dei nomi: Microsoft.VisualBasic
Modulo: Collection
Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)