IEnumerator.Current Propiedad
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í.
Obtiene el elemento de la colección situado en la posición actual del enumerador.
public:
property System::Object ^ Current { System::Object ^ get(); };
public object Current { get; }
public object? Current { get; }
member this.Current : obj
Public ReadOnly Property Current As Object
Valor de propiedad
Elemento de la colección en la posición actual del enumerador.
Ejemplos
En el ejemplo de código siguiente se muestra la implementación de las IEnumerator interfaces de una colección personalizada. En este ejemplo, Current no se llama explícitamente, pero se implementa para admitir el uso de foreach
(for each
en Visual Basic). Este ejemplo de código forma parte de un ejemplo más grande para la IEnumerator interfaz .
// When you implement IEnumerable, you must also implement IEnumerator.
public class PeopleEnum : IEnumerator
{
public Person[] _people;
// Enumerators are positioned before the first element
// until the first MoveNext() call.
int position = -1;
public PeopleEnum(Person[] list)
{
_people = list;
}
public bool MoveNext()
{
position++;
return (position < _people.Length);
}
public void Reset()
{
position = -1;
}
object IEnumerator.Current
{
get
{
return Current;
}
}
public Person Current
{
get
{
try
{
return _people[position];
}
catch (IndexOutOfRangeException)
{
throw new InvalidOperationException();
}
}
}
}
' When you implement IEnumerable, you must also implement IEnumerator.
Public Class PeopleEnum
Implements IEnumerator
Public _people() As Person
' Enumerators are positioned before the first element
' until the first MoveNext() call.
Dim position As Integer = -1
Public Sub New(ByVal list() As Person)
_people = list
End Sub
Public Function MoveNext() As Boolean Implements IEnumerator.MoveNext
position = position + 1
Return (position < _people.Length)
End Function
Public Sub Reset() Implements IEnumerator.Reset
position = -1
End Sub
Public ReadOnly Property Current() As Object Implements IEnumerator.Current
Get
Try
Return _people(position)
Catch ex As IndexOutOfRangeException
Throw New InvalidOperationException()
End Try
End Get
End Property
End Class
Comentarios
Current no está definido en cualquiera de las condiciones siguientes:
El enumerador se coloca antes del primer elemento de la colección, inmediatamente después de crear el enumerador. MoveNext se debe llamar a para avanzar el enumerador al primer elemento de la colección antes de leer el valor de Current.
Última llamada a MoveNext devuelta
false
, que indica el final de la colección.El enumerador se invalida debido a los cambios realizados en la colección, como agregar, modificar o eliminar elementos.
Current devuelve el mismo objeto hasta que se llama a MoveNext. MoveNext establece Current en el siguiente elemento.