KeyContainerPermissionAccessEntryEnumerator Classe

Definizione

Rappresenta l'enumeratore per gli oggetti KeyContainerPermissionAccessEntry in un insieme KeyContainerPermissionAccessEntryCollection.Represents the enumerator for KeyContainerPermissionAccessEntry objects in a KeyContainerPermissionAccessEntryCollection.

public ref class KeyContainerPermissionAccessEntryEnumerator sealed : System::Collections::IEnumerator
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class KeyContainerPermissionAccessEntryEnumerator : System.Collections.IEnumerator
type KeyContainerPermissionAccessEntryEnumerator = class
    interface IEnumerator
Public NotInheritable Class KeyContainerPermissionAccessEntryEnumerator
Implements IEnumerator
Ereditarietà
KeyContainerPermissionAccessEntryEnumerator
Attributi
Implementazioni

Commenti

Gli enumeratori consentono solo la lettura dei dati nella raccolta.Enumerators allow only reading the data in the collection. Non è possibile usare gli enumeratori per modificare la raccolta sottostante.Enumerators cannot be used to modify the underlying collection.

Inizialmente l'enumeratore è posizionato davanti al primo elemento della raccolta.Initially, the enumerator is positioned before the first element in the collection. Anche Reset il metodo riporta l'enumeratore in questa posizione.The Reset method also brings the enumerator back to this position. In questa posizione, la chiamata Current della proprietà genera un'eccezione.At this position, calling the Current property throws an exception. Pertanto, è necessario chiamare il MoveNext metodo per far avanzare l'enumeratore al primo elemento della raccolta prima di leggere il valore Current della proprietà.Therefore, you must call the MoveNext method to advance the enumerator to the first element of the collection before reading the value of the Current property.

Current restituisce lo stesso oggetto finché non viene chiamato il metodo MoveNext o Reset.Current returns the same object until either MoveNext or Reset is called. MoveNext imposta Current sull'elemento successivo.MoveNext sets Current to the next element.

Una volta raggiunta la fine della raccolta, l'enumeratore sarà posizionato dopo l'ultimo elemento, pertanto la chiamata al metodo MoveNext restituisce false.After the end of the collection is passed, the enumerator is positioned after the last element in the collection, and calling MoveNext returns false. Se l'ultima chiamata a MoveNext ha falserestituito, Current la chiamata a genera un'eccezione.If the last call to MoveNext returned false, calling Current throws an exception. Per reimpostare Current il primo elemento della raccolta, chiamare Reset seguito da una chiamata a MoveNext.To reset Current to the first element of the collection, call Reset followed by a call to MoveNext.

Un enumeratore rimane valido fino a quando la raccolta non subisce modifiche.An enumerator remains valid as long as the collection remains unchanged. Se vengono apportate modifiche alla raccolta, ad esempio l'aggiunta, la modifica o l'eliminazione di elementi, l'enumeratore viene irrimediabilmente invalidato MoveNext e Reset la chiamata InvalidOperationExceptionsuccessiva a o genera un'eccezione.If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated and the next call to MoveNext or Reset throws an InvalidOperationException. Se la raccolta viene modificata tra la MoveNext chiamata Currenta Current e, restituisce l'elemento al quale è attualmente impostato, anche se l'enumeratore è già stato invalidato.If the collection is modified between calling MoveNext and Current, Current returns the element to which it is currently set, even if the enumerator is already invalidated.

L'enumeratore non dispone di accesso esclusivo alla raccolta. L'enumerazione di una raccolta non è quindi una procedura thread-safe.The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure. Anche se una raccolta è sincronizzata, è possibile che venga modificata da altri thread, con conseguente generazione di un'eccezione da parte dell'enumeratore.Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. Per garantire la protezione dei thread durante l'enumerazione, è possibile bloccare la raccolta per l'intera enumerazione oppure intercettare le eccezioni determinate dalle modifiche apportate da altri thread.To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.

Costruttori

KeyContainerPermissionAccessEntryEnumerator()

Proprietà

Current

Ottiene la voce corrente presente nell'insieme.Gets the current entry in the collection.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MoveNext()

Passa all'elemento successivo dell'insieme.Moves to the next element in the collection.

Reset()

Reimposta l'enumeratore all'inizio dell'insieme.Resets the enumerator to the beginning of the collection.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IEnumerator.Current

Ottiene l'oggetto corrente della raccolta.Gets the current object in the collection.

Si applica a