Transform3DCollection.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:
System::Windows::Media::Media3D::Transform3DCollection::Enumerator GetEnumerator();public System.Windows.Media.Media3D.Transform3DCollection.Enumerator GetEnumerator();member this.GetEnumerator : unit -> System.Windows.Media.Media3D.Transform3DCollection.EnumeratorPublic Function GetEnumerator () As Transform3DCollection.EnumeratorDevoluções
Um enumerador que pode iterar a coleção.
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. também traz o recenseador de volta a esta posição. Nesta posição, chamar Current lança uma exceção. Por isso, deve ligar MoveNext para avançar o enumerador para o primeiro item da coleção antes de ler o valor do Current.
O Current devolve o mesmo objeto até ser chamado MoveNext ou Reset MoveNext. O MoveNext define o Atual para o item seguinte.
Após o fim da coleção, o enumerador é posicionado após o último item da coleção, e chamar o MoveNext retorna falso. Se a última chamada ao MoveNext devolveu falso, chamar o Current lança uma exceção. Para definir Current como o primeiro item da coleção, podes 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 para MoveNext ou Reset gera uma 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.
