Hashtable.Synchronized(Hashtable) Метод

Определение

Пространство имен:

System.Collections

Сборка:

mscorlib.dll

Возвращает синхронизированный (потокобезопасный) оболочку для Hashtable.

public:
 static System::Collections::Hashtable ^ Synchronized(System::Collections::Hashtable ^ table);

public static System.Collections.Hashtable Synchronized(System.Collections.Hashtable table);

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

Public Shared Function Synchronized (table As Hashtable) As Hashtable

Параметры

table

Hashtable

Синхронизация Hashtable .

Возвращаемое значение

Hashtable

Синхронизированный (потокобезопасный) оболочка для Hashtable.

Исключения

ArgumentNullException

table равно null.

Примеры

В следующем примере показано, как синхронизировать объект Hashtable, определить Hashtable , синхронизирована ли она, и использовать синхронизированную Hashtable.

using System;
using System.Collections;

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

        // Creates a synchronized wrapper around the Hashtable.
        Hashtable mySyncdHT = Hashtable.Synchronized(myHT);

        // Displays the sychronization status of both Hashtables.
        Console.WriteLine("myHT is {0}.", myHT.IsSynchronized ? "synchronized" : "not synchronized");
        Console.WriteLine("mySyncdHT is {0}.", mySyncdHT.IsSynchronized ? "synchronized" : "not synchronized");
    }
}

/*
This code produces the following output.

myHT is not synchronized.
mySyncdHT is synchronized.
*/

Imports System.Collections

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

' This code produces the following output.
' 
' myHT is not synchronized.
' mySyncdHT is synchronized.

Комментарии

Этот Synchronized метод является потокобезопасной для нескольких читателей и средств записи. Кроме того, синхронизированная оболочка гарантирует, что за один модуль записи одновременно существует только один модуль записи.

Перечисление через коллекцию по сути не является потокобезопасной процедурой. Даже если коллекция синхронизирована, другие потоки по-прежнему могут изменять коллекцию, что приводит к возникновению исключения перечислителем. Чтобы гарантировать безопасность потоков во время перечисления, можно заблокировать коллекцию во время всего перечисления или поймать исключения, полученные из изменений, внесенных другими потоками.

В следующем примере кода показано, как заблокировать коллекцию с помощью SyncRoot всего перечисления:

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

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

Этот метод является операцией O(1) .

См. также раздел

• IsSynchronized
• SyncRoot