BreakpointTargetEnumerator Classe

Definizione

public ref class BreakpointTargetEnumerator sealed : Microsoft::SqlServer::Dts::Runtime::DtsEnumerator

public sealed class BreakpointTargetEnumerator : Microsoft.SqlServer.Dts.Runtime.DtsEnumerator

type BreakpointTargetEnumerator = class
    inherit DtsEnumerator

Public NotInheritable Class BreakpointTargetEnumerator
Inherits DtsEnumerator

Ereditarietà

Object

DtsEnumerator

BreakpointTargetEnumerator

Commenti

Gli enumeratori abilitano solo la lettura dei dati nella raccolta. Non è possibile utilizzare enumeratori per modificare la raccolta sottostante.

Inizialmente, l'enumeratore viene posizionato prima del primo elemento della raccolta. Il Reset metodo riporta anche l'enumeratore in questa posizione. In questa posizione, la chiamata alla Current proprietà genera un'eccezione. Pertanto, devi chiamare MoveNext il metodo per avanzare l'enumeratore al primo elemento della collezione prima di leggere il valore di Current.

Current restituisce lo stesso oggetto finché non MoveNext viene chiamato o Reset . MoveNext imposta Current sull'elemento successivo.

Dopo aver passato la fine della raccolta, l'enumeratore viene posizionato dopo l'ultimo elemento della raccolta e la chiamata MoveNext restituisce false. Se l'ultima chiamata a MoveNext restituisce false, la chiamata Current genera un'eccezione. Per impostare Current di nuovo sul primo elemento della raccolta, è possibile chiamare Reset seguito da MoveNext.

Un enumeratore rimane valido finché la raccolta rimane invariata. Se vengono apportate modifiche alla collezione, come aggiungere, modificare o eliminare elementi, l'enumeratore viene invalidato e diventa irrecuperabile; quindi la chiamata successiva a MoveNext o Reset lancia un InvalidOperationException. Tuttavia, se la collezione viene modificata tra MoveNext e Current, Current restituirà l'elemento a cui è impostata, anche se l'enumeratore è stato invalidato.

L'enumeratore non ha accesso esclusivo alla collezione; Pertanto, enumerare attraverso una collezione non è una procedura thread-safe. Anche quando una raccolta viene sincronizzata, altri thread potrebbero comunque modificare la raccolta, causando la generazione di un'eccezione da parte dell'enumeratore. Per garantire la thread safety durante l'enumerazione, è possibile bloccare la raccolta durante l'intera enumerazione o intercettare le eccezioni risultanti dalle modifiche apportate da altri thread.