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 。 同步代码必须对 SyncRoot 的 NameObjectCollectionBase.KeysCollection执行操作,而不是直接对 NameObjectCollectionBase.KeysCollection执行操作。 这样可确保对从其他对象派生的集合正确地执行操作。 具体而言,它会保持与可能同时修改 NameObjectCollectionBase.KeysCollection 对象的其他线程的正确同步。
枚举整个集合本质上不是一个线程安全的过程。 即使某个集合已同步,其他线程仍可以修改该集合,这会导致枚举数引发异常。 若要确保枚举过程中的线程安全性,可以在整个枚举期间锁定集合,或者捕获由其他线程进行的更改所导致的异常。