MRUSecurityTokenCache.GetEnumerator Method

  • Article

Gets an IEnumerator that can iterate through the cache.

Namespace: Microsoft.Web.Services3.Security.Tokens
Assembly: Microsoft.Web.Services3 (in microsoft.web.services3.dll)

Usage

'Usage
Dim returnValue As IEnumerator
Dim mRUSecurityTokenCache1 As MRUSecurityTokenCache
returnValue = mRUSecurityTokenCache1.GetEnumerator()

Syntax

'Declaration
Public Overridable Function GetEnumerator() As IEnumerator

public virtual IEnumerator GetEnumerator();

public:
virtual IEnumerator^ GetEnumerator();

public virtual IEnumerator GetEnumerator();

public function GetEnumerator() : IEnumerator;

Return Value

An IEnumerator that iterates through the cache.

Remarks

Enumerators allow only reading the data in the cache. Enumerators cannot be used to modify the underlying cache.

An enumerator remains valid as long as the cache remains unchanged. If changes are made to the cache, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated.

The enumerator does not have exclusive access to the cache; therefore, enumerating through a cache is intrinsically not a thread-safe procedure. Even when a cache is synchronized, other threads could still modify the cache, which causes the enumerator to throw an exception. To maintain thread safety during enumeration, you can either lock the cache during the entire enumeration or catch the exceptions resulting from changes made by other threads.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows 2000, Windows 2000 Server, Windows 2000 Advanced Server

Target Platforms

See Also

Reference

MRUSecurityTokenCache Class
MRUSecurityTokenCache Members
Microsoft.Web.Services3.Security.Tokens Namespace