NameObjectCollectionBase.KeysCollection.ICollection.IsSynchronized プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
NameObjectCollectionBase.KeysCollection へのアクセスが同期されている (スレッド セーフである) かどうかを示す値を取得します。
property bool System::Collections::ICollection::IsSynchronized { bool get(); };bool System.Collections.ICollection.IsSynchronized { get; }member this.System.Collections.ICollection.IsSynchronized : bool ReadOnly Property IsSynchronized As Boolean Implements ICollection.IsSynchronizedプロパティ値
true へのアクセスが同期されている (スレッド セーフである) 場合は NameObjectCollectionBase.KeysCollection。それ以外の場合は false。 既定値は、false です。
実装
例
次のコード例は、列挙体全体を使用してコレクションを SyncRoot ロックする方法を示しています。
// Create a collection derived from NameObjectCollectionBase
NameObjectCollectionBase^ myBaseCollection = gcnew DerivedCollection();
// Get the ICollection from NameObjectCollectionBase.KeysCollection
ICollection^ myKeysCollection = myBaseCollection->Keys;
bool lockTaken = false;
try
{
Monitor::Enter(myKeysCollection->SyncRoot, lockTaken);
for each (Object^ item in myKeysCollection)
{
// Insert your code here.
}
}
finally
{
if (lockTaken)
{
Monitor::Exit(myKeysCollection->SyncRoot);
}
}
// Create a collection derived from NameObjectCollectionBase
NameObjectCollectionBase myBaseCollection = new DerivedCollection();
// Get the ICollection from NameObjectCollectionBase.KeysCollection
ICollection myKeysCollection = myBaseCollection.Keys;
lock(myKeysCollection.SyncRoot)
{
foreach (object item in myKeysCollection)
{
// Insert your code here.
}
}
' Create a collection derived from NameObjectCollectionBase
Dim myBaseCollection As NameObjectCollectionBase = New DerivedCollection()
' Get the ICollection from NameObjectCollectionBase.KeysCollection
Dim myKeysCollection As ICollection = myBaseCollection.Keys
SyncLock myKeysCollection.SyncRoot
For Each item As Object In myKeysCollection
' Insert your code here.
Next item
End SyncLock
このプロパティ値を取得することは、O(1) 操作になります。
注釈
派生クラスは、プロパティを使用して独自の同期バージョンをNameObjectCollectionBase.KeysCollectionSyncRoot提供できます。 同期コードは、直接ではなく、SyncRootNameObjectCollectionBase.KeysCollectionそのコードに対して操作を実行するNameObjectCollectionBase.KeysCollection必要があります。 こうすることにより、他のオブジェクトから派生したコレクションを適切に操作することができます。 具体的には、オブジェクトを同時に変更する可能性がある他のスレッドとの適切な同期が NameObjectCollectionBase.KeysCollection 維持されます。
コレクションの列挙処理は、本質的にスレッドセーフな処理ではありません。 コレクションが同期されていても、他のスレッドがコレクションを変更する場合があり、このときは列挙子から例外がスローされます。 列挙処理を確実にスレッド セーフに行うには、列挙中にコレクションをロックするか、他のスレッドによって行われた変更によってスローされる例外をキャッチします。