KeyContainerPermissionAccessEntryEnumerator クラス

.NET Framework クラス ライブラリ リファレンス

KeyContainerPermissionAccessEntryEnumerator クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

KeyContainerPermissionAccessEntryCollection 内の KeyContainerPermissionAccessEntry オブジェクトの列挙子を表します。

名前空間: System.Security.Permissions
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class
 KeyContainerPermissionAccessEntryEnumerator
    Implements IEnumerator

Visual Basic (使用法)

Dim instance As KeyContainerPermissionAccessEntryEnumerator

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public sealed class KeyContainerPermissionAccessEntryEnumerator
 : IEnumerator

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class KeyContainerPermissionAccessEntryEnumerator
 sealed : IEnumerator

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class KeyContainerPermissionAccessEntryEnumerator
 implements IEnumerator

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public final class KeyContainerPermissionAccessEntryEnumerator
 implements IEnumerator

解説

列挙子は、コレクション内のデータの読み取りだけを許可します。列挙子を使用して基になるコレクションを変更することはできません。

最初に、列挙子はコレクションの最初の要素の前に配置されます。また、Reset メソッドは、列挙子を最初の位置に戻します。この位置で Current プロパティを呼び出すと、例外がスローされます。したがって、Current プロパティの値を読み取る前に、MoveNext メソッドを呼び出して、コレクションの最初の要素に列挙子を進める必要があります。

Current は、MoveNext または Reset が呼び出されるまでは同じオブジェクトを返します。MoveNext は、Current を次の要素に設定します。

コレクションの末尾を過ぎると、列挙子はコレクションの最後の要素の後ろに配置され、MoveNext を呼び出すと false が返されます。MoveNext への最後の呼び出しで false が返された場合に、Current を呼び出すと例外がスローされます。Current をコレクションの最初の要素にリセットするには、Reset、MoveNext の順に呼び出します。

コレクションが変更されない限り、列挙子は有効なままです。要素の追加、変更、削除などの変更がコレクションに対して実行されると、列挙子は回復不可能な無効状態になり、次に MoveNext または Reset を呼び出すと InvalidOperationException がスローされます。コレクションが MoveNext の呼び出しと Current の呼び出しとの間で変更された場合、Current は、列挙子が既に無効になっていても、現在設定されている要素を返します。

列挙子には、コレクションへの排他的なアクセスがありません。したがって、コレクションの列挙処理は、本質的にはスレッド セーフな処理ではありません。コレクションが同期されている場合でも、他のスレッドがそのコレクションを変更する可能性はあり、そのような状況が発生すると列挙子は例外をスローします。列挙処理を確実にスレッド セーフに行うには、列挙中にコレクションをロックするか、他のスレッドによって行われた変更によってスローされる例外をキャッチします。

継承階層

System.Object
  System.Security.Permissions.KeyContainerPermissionAccessEntryEnumerator

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
KeyContainerPermissionAccessEntryEnumerator メンバ
System.Security.Permissions 名前空間