EventInfos.GetEnumerator Metodo

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Restituisce un enumeratore da utilizzare nell'iterazione della raccolta EventInfos.

public:
 Microsoft::SqlServer::Dts::Runtime::EventInfoEnumerator ^ GetEnumerator();

public Microsoft.SqlServer.Dts.Runtime.EventInfoEnumerator GetEnumerator ();

override this.GetEnumerator : unit -> Microsoft.SqlServer.Dts.Runtime.EventInfoEnumerator

Public Function GetEnumerator () As EventInfoEnumerator

Restituisce

EventInfoEnumerator

Oggetto EventInfoEnumerator.

Commenti

Gli enumeratori devono essere usati solo per leggere i dati nella raccolta. Gli enumeratori non possono essere usati per modificare la raccolta sottostante.

L'enumeratore non ha accesso esclusivo alla raccolta.

Quando viene creato un enumeratore, accetta uno snapshot dello stato corrente della raccolta. Se le modifiche vengono apportate alla raccolta, ad esempio l'aggiunta, la modifica o l'eliminazione di elementi, lo snapshot non viene eseguito dalla sincronizzazione e l'enumeratore genera un InvalidOperationExceptionoggetto . Due enumeratori creati contemporaneamente dalla stessa raccolta possono avere snapshot diversi della raccolta.

L'enumeratore è in uno stato che non è valido se viene posizionato prima del primo elemento della raccolta o dopo l'ultimo elemento della raccolta. Ogni volta che l'enumeratore si trova in uno stato non valido, la chiamata Current genera un'eccezione.

Inizialmente l'enumeratore è posizionato davanti al primo elemento della raccolta. Anche il metodo Reset riporta l'enumeratore in questa posizione. Pertanto, dopo la creazione di un enumeratore o dopo Reset, MoveNext deve essere chiamato per avanzare l'enumeratore al primo elemento della raccolta prima di leggere il valore di Current.

Current restituisce lo stesso oggetto finché non viene chiamato il metodo MoveNext o Reset.

Dopo aver superato la fine della raccolta, l'enumeratore viene nuovamente in uno stato non valido e chiamante MoveNext restituisce false. La chiamata Current genera un'eccezione se l'ultima chiamata a MoveNext restituisce false.