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 : objPublic ReadOnly Property SyncRoot As ObjectPublic 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) 操作になります。