NameObjectCollectionBase.KeysCollection.ICollection.IsSynchronized Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, показывающее, является ли доступ к коллекции 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.KeysCollection с помощью SyncRoot свойства . Синхронный код должен выполнять операции с SyncRootNameObjectCollectionBase.KeysCollection, а не непосредственно с NameObjectCollectionBase.KeysCollection. Это обеспечивает правильную работу коллекций, являющихся производными других объектов. В частности, он поддерживает правильную синхронизацию с другими потоками, которые могут одновременно изменять NameObjectCollectionBase.KeysCollection объект .
Перечисление коллекции не является потокобезопасной процедурой. Даже если коллекция синхронизирована, другие потоки могут ее изменить, что приведет к тому, что перечислитель создаст исключение. Для обеспечения потокобезопасности при перечислении можно либо заблокировать коллекцию на все время перечисления, либо перехватывать исключения, возникающие в результате изменений, внесенных другими потоками.