HashSet<T>.Enumerator Estructura
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Enumera los elementos de un HashSet<T> objeto .
public: value class HashSet<T>::Enumerator : System::Collections::Generic::IEnumerator<T>public struct HashSet<T>.Enumerator : System.Collections.Generic.IEnumerator<T>[System.Serializable]
public struct HashSet<T>.Enumerator : System.Collections.Generic.IEnumerator<T>type HashSet<'T>.Enumerator = struct
interface IEnumerator<'T>
interface IEnumerator
interface IDisposable[<System.Serializable>]
type HashSet<'T>.Enumerator = struct
interface IEnumerator<'T>
interface IDisposable
interface IEnumeratorPublic Structure HashSet(Of T).Enumerator
Implements IEnumerator(Of T)Parámetros de tipo
- T
- Herencia
- Atributos
- Implementaciones
Comentarios
La foreach instrucción del lenguaje C# (For Each en Visual Basic) oculta la complejidad de los enumeradores. Por lo tanto, se recomienda usar foreach , en lugar de manipular directamente el enumerador.
Los enumeradores se pueden usar para leer los datos de la colección, pero no se pueden usar para modificar la colección subyacente.
Inicialmente, el enumerador se coloca antes del primer elemento de la colección. En esta posición, la Current propiedad no está definida. Por lo tanto, debe llamar al MoveNext método para avanzar el enumerador al primer elemento de la colección antes de leer el valor de Current.
Current devuelve el mismo objeto hasta MoveNext que se llama a . MoveNext establece Current en el elemento siguiente.
Si MoveNext pasa el final de la colección, el enumerador se coloca después del último elemento de la colección y MoveNext devuelve false. Cuando el enumerador está en esta posición, las llamadas posteriores a MoveNext también devuelven false. Si la última llamada a MoveNext se falsedevuelve , Current no está definida. No se puede establecer Current de nuevo en el primer elemento de la colección; debe crear un nuevo objeto enumerador en su lugar.
Un enumerador sigue siendo válido siempre que la colección permanezca sin cambios. Si se realizan cambios en la colección, como agregar, modificar o eliminar elementos, el enumerador se invalida irrecuperablemente y la siguiente llamada a MoveNext o IEnumerator.Reset produce una InvalidOperationExceptionexcepción .
El enumerador no tiene acceso exclusivo a la colección; por lo tanto, la enumeración a través de una colección no es intrínsecamente un procedimiento seguro para subprocesos. Para garantizar la seguridad de los subprocesos durante la enumeración, puede bloquear la colección durante toda la enumeración. Para permitir que varios subprocesos puedan acceder a la colección para leer y escribir, debe implementar su propia sincronización.
Las implementaciones predeterminadas de colecciones en el System.Collections.Generic espacio de nombres no se sincronizan.
Propiedades
| Nombre | Description |
|---|---|
| Current |
Obtiene el elemento en la posición actual del enumerador. |
Métodos
| Nombre | Description |
|---|---|
| Dispose() |
Libera todos los recursos usados por un HashSet<T>.Enumerator objeto . |
| MoveNext() |
Desplaza el enumerador al siguiente elemento de la HashSet<T> colección. |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IEnumerator.Current |
Obtiene el elemento en la posición actual del enumerador. |
| IEnumerator.Reset() |
Establece el enumerador en su posición inicial, que es antes del primer elemento de la colección. |
