KeyContainerPermissionAccessEntryEnumerator Classe
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.
Representa o enumerador para KeyContainerPermissionAccessEntry objetos num KeyContainerPermissionAccessEntryCollection.
public ref class KeyContainerPermissionAccessEntryEnumerator sealed : System::Collections::IEnumerator
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class KeyContainerPermissionAccessEntryEnumerator : System.Collections.IEnumerator
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type KeyContainerPermissionAccessEntryEnumerator = class
interface IEnumerator
Public NotInheritable Class KeyContainerPermissionAccessEntryEnumerator
Implements IEnumerator
- Herança
-
KeyContainerPermissionAccessEntryEnumerator
- Atributos
- Implementações
Observações
Atenção
O CAS (Code Access Security) foi preterido em todas as versões do .NET Framework e do .NET. As versões recentes do .NET não respeitam as anotações do CAS e produzem erros se as APIs relacionadas ao CAS forem usadas. Os desenvolvedores devem procurar meios alternativos de realizar tarefas de segurança.
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.
Propriedades
| Name | Description |
|---|---|
| Current |
Obtém a entrada atual na coleção. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MoveNext() |
Passa para o próximo elemento da coleção. |
| Reset() |
Reinicia o enumerador para o início da coleção. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IEnumerator.Current |
Obtém o objeto atual na coleção. |