SortedList.Synchronized(SortedList) Metódus

Definíció

Névtér:

System.Collections

Szerelvények:

netstandard.dll, System.Collections.NonGeneric.dll

Forrás:

SortedList.cs

Egy objektum szinkronizált (szálbiztos) burkolóját SortedList adja vissza.

public:
 static System::Collections::SortedList ^ Synchronized(System::Collections::SortedList ^ list);

public static System.Collections.SortedList Synchronized(System.Collections.SortedList list);

static member Synchronized : System.Collections.SortedList -> System.Collections.SortedList

Public Shared Function Synchronized (list As SortedList) As SortedList

Paraméterek

list

SortedList

A SortedList szinkronizálandó objektum.

Válaszok

SortedList

Szinkronizált (szálbiztos) burkoló az SortedList objektumhoz.

Kivételek

ArgumentNullException

list az null.

Példák

Az alábbi példakód bemutatja, hogyan zárolhatja a gyűjteményt a SyncRoot tulajdonság használatával a teljes enumerálás során.

SortedList myCollection = new SortedList();
lock (myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}

Dim myCollection As New SortedList()
SyncLock myCollection.SyncRoot
    For Each item In myCollection
        ' Insert your code here.
    Next item
End SyncLock

Ez a metódus egy O(1) művelet.

Az alábbi példakód bemutatja, hogyan szinkronizálhat egy SortedList objektumot, állapíthatja meg, hogy egy szinkronizált objektum szinkronizálva van-e SortedList , és hogyan használhat szinkronizált SortedListobjektumot.

using System;
using System.Collections;

public class SamplesSortedList
{
    public static void Main()
    {
        // Creates and initializes a new SortedList.
        SortedList mySL = new SortedList();
        mySL.Add(2, "two");
        mySL.Add(3, "three");
        mySL.Add(1, "one");
        mySL.Add(0, "zero");
        mySL.Add(4, "four");

        // Creates a synchronized wrapper around the SortedList.
        SortedList mySyncdSL = SortedList.Synchronized(mySL);

        // Displays the sychronization status of both SortedLists.
        Console.WriteLine("mySL is {0}.", mySL.IsSynchronized ? "synchronized" : "not synchronized");
        Console.WriteLine("mySyncdSL is {0}.", mySyncdSL.IsSynchronized ? "synchronized" : "not synchronized");
    }
}
/*
This code produces the following output.

mySL is not synchronized.
mySyncdSL is synchronized.
*/

Imports System.Collections

Public Class SamplesSortedList
    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new SortedList.
        Dim mySL As New SortedList()
        mySL.Add(2, "two")
        mySL.Add(3, "three")
        mySL.Add(1, "one")
        mySL.Add(0, "zero")
        mySL.Add(4, "four")
        
        ' Creates a synchronized wrapper around the SortedList.
        Dim mySyncdSL As SortedList = SortedList.Synchronized(mySL)
        
        ' Displays the sychronization status of both SortedLists.
        Dim msg As String
        If mySL.IsSynchronized Then
            msg = "synchronized"
        Else
            msg = "not synchronized"
        End If
        Console.WriteLine("mySL is {0}.", msg)
        If mySyncdSL.IsSynchronized Then
            msg = "synchronized"
        Else
            msg = "not synchronized"
        End If
        Console.WriteLine("mySyncdSL is {0}.", msg)        
    End Sub
End Class

' This code produces the following output.
'
' mySL is not synchronized.
' mySyncdSL is synchronized.

Megjegyzések

Egy objektum menetbiztonságának SortedList garantálása érdekében minden műveletet csak ezen a burkolón keresztül kell végrehajtani.

A gyűjteményen keresztüli számbavétel alapvetően nem szálbiztos eljárás. A gyűjtemény szinkronizálása esetén is más szálak módosíthatják a gyűjteményt, ami miatt az enumerátor kivételt okoz. Az enumerálás során a szálbiztonság garantálása érdekében zárolhatja a gyűjteményt a teljes enumerálás során, vagy elkaphatja a más szálak által végrehajtott módosításokból eredő kivételeket.

Lásd még

• IsSynchronized
• SyncRoot