Array.SyncRoot 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得可用以同步存取 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
屬性值
可用來同步存取 Array 的物件。
實作
範例
下列程式碼範例示範如何使用 屬性,在整個列舉 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) 運算。