Array.SyncRoot Свойство

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Получает объект, с помощью которого можно синхронизировать доступ к коллекции Array.

public:
 property System::Object ^ SyncRoot { System::Object ^ get(); };

public:
 virtual property System::Object ^ SyncRoot { System::Object ^ get(); };

public object SyncRoot { get; }

public virtual object SyncRoot { get; }

member this.SyncRoot : obj

Public ReadOnly Property SyncRoot As Object

Public Overridable ReadOnly Property SyncRoot As Object

Значение свойства

Object

Объект, который может быть использован для синхронизации доступа к коллекции Array.

Реализации

SyncRoot

Примеры

В следующем примере кода показано, как заблокировать массив во время всего перечисления с помощью SyncRoot свойства.

Array^ myArray = gcnew array<Int32> { 1, 2, 4 };
try
{
    Monitor::Enter(myArray->SyncRoot); 
        
    for each (Int32 item in myArray)
        Console::WriteLine(item);
}
finally
{
    Monitor::Exit(myArray->SyncRoot);
}

Array myArray = new int[] { 1, 2, 4 };
lock(myArray.SyncRoot)
{
    foreach (Object item in myArray)
        Console.WriteLine(item);
}

let myArray = [| 1; 2; 4|]
lock myArray.SyncRoot (fun () ->
    for item in myArray do
        printfn $"{item}" )

Dim myArray As Array = New Integer() { 1, 2, 4 }
SyncLock(myArray.SyncRoot) 
    For Each item As Object In myArray
        Console.WriteLine(item)
    Next
End SyncLock

Комментарии

Это свойство реализует System.Collections.ICollection интерфейс.

.NET классы на Array основе предоставления собственной синхронизированной версии коллекции с помощью SyncRoot свойства.

Классы, использующие массивы, также могут реализовать собственную синхронизацию SyncRoot с помощью свойства. Синхронный код должен выполнять операции с SyncRoot коллекцией, а не непосредственно в коллекции. Это обеспечивает правильную работу коллекций, являющихся производными других объектов. В частности, она поддерживает правильную синхронизацию с другими потоками, которые могут одновременно изменять коллекцию. Обратите внимание, что некоторые реализации SyncRoot могут вернуть сам себя Array .

Перечисление через коллекцию по сути не является потокобезопасной процедурой. Даже если коллекция синхронизирована, другие потоки могут ее изменить, что приведет к тому, что перечислитель создаст исключение. Для обеспечения потокобезопасности при перечислении можно либо заблокировать коллекцию на все время перечисления, либо перехватывать исключения, возникающие в результате изменений, внесенных другими потоками.

Получение значения данного свойства является операцией порядка сложности O(1).

См. также раздел

• IsSynchronized