Array.SyncRoot 属性

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

Array.cs

获取可用于同步对 Array 的访问的对象。

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

public object SyncRoot { get; }

member this.SyncRoot : obj

Public 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 接口。

基于 Array 的 .NET 类使用 SyncRoot 属性提供其自己的集合同步版本。

使用数组的类还可以使用 SyncRoot 属性实现其自己的同步。 同步代码必须对 SyncRoot 集合的 执行操作，而不是直接对集合执行操作。 这样可确保对从其他对象派生的集合正确地执行操作。 具体而言，它会保持与可能同时修改集合的其他线程的正确同步。 请注意， 的某些 SyncRoot 实现可能会返回 Array 本身。

通过集合枚举本质上不是线程安全的过程。 即使某个集合已同步，其他线程仍可以修改该集合，这会导致枚举数引发异常。 若要确保枚举过程中的线程安全性，可以在整个枚举期间锁定集合，或者捕获由其他线程进行的更改所导致的异常。

检索此属性的值的运算复杂度为 O(1)。

另请参阅

• IsSynchronized