EventInfos.GetEnumerator Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne un énumérateur à utiliser pour effectuer une itération au sein de la collection 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
Retours
Objet EventInfoEnumerator.
Remarques
Les énumérateurs sont destinés à être utilisés uniquement pour lire des données dans la collection. Les énumérateurs ne peuvent pas être utilisés pour modifier la collection sous-jacente.
L’énumérateur n’a pas accès exclusif à la collection.
Lorsqu’un énumérateur est créé, il prend un instantané de l’état actuel de la collection. Si des modifications sont apportées à la collection, comme l’ajout, la modification ou la suppression d’éléments, l’instantané sort de la synchronisation et l’énumérateur lève un InvalidOperationException
. Deux énumérateurs créés à partir de la même collection peuvent avoir des instantanés différents de la collection.
L’énumérateur est dans un état qui n’est pas valide s’il est positionné avant le premier élément de la collection ou après le dernier élément de la collection. Chaque fois que l’énumérateur est dans un état qui n’est pas valide, l’appel Current
lève une exception.
Au départ, l'énumérateur est positionné avant le premier élément de la collection. Reset
replace également l'énumérateur à cette position. Par conséquent, une fois qu’un énumérateur est créé ou après Reset
, MoveNext
doit être appelé pour avancer l’énumérateur vers le premier élément de la collection avant de lire la valeur de Current
.
Current
retourne le même objet tant que MoveNext
ou Reset
n'est pas appelé.
Une fois la fin de la collection passée, l’énumérateur est de nouveau dans un état qui n’est pas valide et appelant MoveNext
retourne false
. L’appel Current
lève une exception si le dernier appel à MoveNext
retourner false
.