Collection.GetEnumerator Metodo

Definizione

Restituisce un enumeratore che consente di scorrere la raccolta.Returns an enumerator that iterates through the collection.

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.An enumerator that can be used to iterate through the collection.

Esempio

Nell'esempio seguente viene illustrato come utilizzare GetEnumerator per recuperare tutti gli elementi di un Collection oggetto.The following example shows how to use GetEnumerator to retrieve all the elements of a Collection object.

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' IEnumerator interfaccia dello System.Collections spazio dei nomi.GetEnumerator constructs and returns an enumerator object, which implements the IEnumerator interface of the System.Collections namespace. L'oggetto enumeratore espone la Current proprietà e MoveNext i Reset metodi e.The enumerator object exposes the Current property and the MoveNext and Reset methods. Per ulteriori informazioni, vedere for each... Istruzione successiva.For more information, see For Each...Next Statement.

Commenti

Oggetto per ogni... L'istruzione successiva chiama GetEnumerator per ottenere un oggetto enumeratore per supportare l'iterazione sugli elementi di una raccolta.The For Each...Next Statement calls GetEnumerator to obtain an enumerator object to support iteration over a collection's elements. In genere, si usa un For Each ciclo... Next per attraversare una raccolta o una matrice e non è necessario chiamare in GetEnumerator modo esplicito.Normally, you use a For Each...Next loop to traverse a collection or array, and you do not need to call GetEnumerator explicitly.

Se è necessario un controllo più stretto sull'iterazione che le For Each istruzioni... Next forniscono, è possibile usare il GetEnumerator metodo per eseguire un attraversamento personalizzato.If you need closer control over the iteration than the For Each...Next statements provide, you can use the GetEnumerator method to perform a customized traversal. Di seguito sono riportati alcuni casi in cui potrebbe essere necessario eseguire questa operazione.The following are some cases in which you might need to do this.

  • Potrebbe essere necessario tornare all'inizio della raccolta e avviare di nuovo l'iterazione prima che sia terminata.You might want to return to the beginning of the collection and start the iteration again before it is finished.

  • Potrebbe essere necessario ignorare uno o più elementi per diversi motivi.You might want to skip over one or more elements for a variety of reasons.

  • Potrebbe essere necessario modificare gli elementi della raccolta nel mezzo di un attraversamento.You might need to change the elements of the collection in the middle of a traversal. In questo caso è necessario ottenere un nuovo oggetto enumeratore perché quello precedente è invalidato.In this case you must obtain a new enumerator object because the previous one is invalidated.

Si applica a