IEnumeratorContract<T> Interfaz
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 una colección IListContract<T>.
generic <typename T>
public interface class IEnumeratorContract : IDisposable
public interface IEnumeratorContract<T> : IDisposable
type IEnumeratorContract<'T> = interface
interface IDisposable
Public Interface IEnumeratorContract(Of T)
Implements IDisposable
Parámetros de tipo
- T
Tipo de los objetos que están enumerándose.
- Implementaciones
Comentarios
Los enumeradores se pueden usar para leer los datos de la colección, pero no se pueden usar para modificar la colección.
En principio, el enumerador se coloca antes del primer elemento de la colección. En esta posición, el valor devuelto de GetCurrent no está definido. Por lo tanto, debe llamar MoveNext a para avanzar el enumerador al primer elemento de la colección antes de llamar a GetCurrent.
GetCurrent devuelve el mismo objeto hasta que se llama a MoveNext. MoveNext establece el valor devuelto de GetCurrent 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 también devuelven MoveNextfalse
. Si se devuelve false
la última llamada a MoveNext , el valor devuelto de GetCurrent es indefinido.
Un enumerador sigue siendo válido mientras la colección permanezca inalterada. Si se hacen cambios en la colección (como agregar, modificar o eliminar elementos), el enumerador queda invalidado permanentemente y su comportamiento es indefinido.
Métodos
Dispose() |
Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de IDisposable) |
GetCurrent() |
Devuelve el objeto de la colección situado en la posición actual del enumerador. |
MoveNext() |
Desplaza el enumerador al siguiente elemento de la colección. |
Reset() |
Establece el enumerador en su posición inicial (antes del primer elemento de la colección). |