KeyContainerPermissionAccessEntryEnumerator Classe

Definição

public ref class KeyContainerPermissionAccessEntryEnumerator sealed : System::Collections::IEnumerator

[System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class KeyContainerPermissionAccessEntryEnumerator : System.Collections.IEnumerator

[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class KeyContainerPermissionAccessEntryEnumerator : System.Collections.IEnumerator

public sealed class KeyContainerPermissionAccessEntryEnumerator : System.Collections.IEnumerator

[<System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type KeyContainerPermissionAccessEntryEnumerator = class
    interface IEnumerator

[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type KeyContainerPermissionAccessEntryEnumerator = class
    interface IEnumerator

type KeyContainerPermissionAccessEntryEnumerator = class
    interface IEnumerator

Public NotInheritable Class KeyContainerPermissionAccessEntryEnumerator
Implements IEnumerator

Herança

Object

KeyContainerPermissionAccessEntryEnumerator

Atributos

ObsoleteAttribute ComVisibleAttribute SerializableAttribute

Implementações

IEnumerator

Observações

Os enumeradores permitem apenas a leitura dos dados da coleção. Os enumeradores não podem ser usados para modificar a coleção subjacente.

Inicialmente, o enumerador é posicionado antes do primeiro elemento da coleção. O Reset método também traz o enumerador de volta a esta posição. Nesta posição, chamar a Current propriedade lança uma exceção. Por isso, deve chamar o MoveNext método para avançar o enumerador para o primeiro elemento da coleção antes de ler o valor da Current propriedade.

Current devolve o mesmo objeto até que qualquer MoveNext ou Reset seja chamado. MoveNext passa Current para o elemento seguinte.

Após o fim da coleção, o enumerador é posicionado após o último elemento da coleção, e chamando MoveNext devolve false. Se a última chamada for MoveNext retornada false, chamar Current lança uma exceção. Para reiniciar Current para o primeiro elemento da coleção, chamada Reset seguida de uma chamada para 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 elementos, o enumerador fica irremediavelmente invalidado e a próxima chamada para MoveNext ou Reset lança um InvalidOperationException. Se a coleção for modificada entre chamar MoveNext e Current, Current devolve o elemento ao qual está atualmente 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 ainda podem 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.