BooleanKeyFrameCollection.GetEnumerator Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve um enumerador que pode iterar pela coleção.
public:
virtual System::Collections::IEnumerator ^ GetEnumerator();public System.Collections.IEnumerator GetEnumerator();abstract member GetEnumerator : unit -> System.Collections.IEnumerator
override this.GetEnumerator : unit -> System.Collections.IEnumeratorPublic Function GetEnumerator () As IEnumeratorDevoluções
E IEnumerator que possa iterar pela coleção.
Implementações
Observações
Os enumeradores só permitem a leitura dos dados na coleção. Os enumeradores não podem ser usados para modificar a coleção subjacente.
Inicialmente, o enumerador é colocado antes do primeiro item da coleção. Reset também traz o recenseador de volta a esta posição. Nesta posição, chamar Current lança uma exceção. Portanto, deve ligar MoveNext para avançar o enumerador para o primeiro item da coleção antes de ler o valor de Current.
Current devolve o mesmo objeto até que qualquer MoveNext ou Reset seja chamado. MoveNext passa Current para o item seguinte.
Após o fim da coleção, o enumerador é posicionado após o último item da coleção, e a chamada MoveNext retorna false. Se a última chamada for MoveNext retornada false, chamar Current lança uma exceção. Para definir Current novamente para o primeiro item da coleção, pode chamar Reset seguido de MoveNext.
Um enumerador mantém-se válido enquanto a coleção permanecer inalterada. Se forem feitas alterações à coleção, como adicionar, modificar ou eliminar itens, o enumerador é irremediavelmente invalidado e a próxima chamada ou MoveNextReset lança um InvalidOperationException. Se a coleção for modificada entre MoveNext e Current, Current devolverá o item para o qual está definida, mesmo que o enumerador já esteja invalidado.
O enumerador não tem acesso exclusivo à coleção; Portanto, enumerar através de uma coleção não é intrinsecamente um procedimento seguro para threads. Mesmo quando uma coleção está sincronizada, outros threads podem ainda modificar a coleção, o que faz com que o enumerador lance uma exceção. Para garantir a segurança dos threads durante a enumeração, pode bloquear a coleção durante toda a enumeração ou apanhar as exceções resultantes de alterações feitas por outros threads.