Array.SyncRoot Właściwość

Definicja

Przestrzeń nazw:

System

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

Array.cs

Pobiera obiekt, który może służyć do synchronizowania dostępu do obiektu Array.

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

public object SyncRoot { get; }

member this.SyncRoot : obj

Public ReadOnly Property SyncRoot As Object

Wartość właściwości

Object

Obiekt, który może służyć do synchronizowania dostępu do obiektu Array.

Implementuje

SyncRoot

Przykłady

Poniższy przykład kodu pokazuje, jak zablokować tablicę podczas całego wyliczenia przy użyciu SyncRoot właściwości .

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

Uwagi

Ta właściwość implementuje System.Collections.ICollection interfejs.

Klasy platformy .NET oparte na Array udostępnianiu własnej zsynchronizowanej wersji kolekcji przy użyciu SyncRoot właściwości .

Klasy korzystające z tablic mogą również implementować własną synchronizację SyncRoot przy użyciu właściwości . Synchronizowanie kodu musi wykonywać operacje na SyncRoot kolekcji, a nie bezpośrednio w kolekcji. Zapewnia to właściwą operację kolekcji, które pochodzą z innych obiektów. W szczególności utrzymuje właściwą synchronizację z innymi wątkami, które mogą być jednocześnie modyfikowane kolekcji. Należy pamiętać, że niektóre implementacje SyncRoot programu mogą zwracać same siebie Array .

Wyliczanie za pośrednictwem kolekcji nie jest wewnętrznie bezpieczną procedurą wątku. Nawet w przypadku synchronizacji kolekcji inne wątki nadal mogą modyfikować kolekcję, co powoduje zgłoszenie wyjątku przez moduł wyliczający. Aby zagwarantować bezpieczeństwo wątków podczas wyliczania, możesz zablokować kolekcję podczas całego wyliczenia lub przechwycić wyjątki wynikające ze zmian wprowadzonych przez inne wątki.

Pobieranie wartości tej właściwości jest operacją O(1).

Zobacz też

• IsSynchronized