Hashtable.Synchronized(Hashtable) Yöntem

Tanım

Ad Alanı:

System.Collections

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

Hashtable.cs

için eşitlenmiş (iş parçacığı güvenli) sarmalayıcı döndürür 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

Parametreler

table

Hashtable

Eşitlenecek Hashtable .

Döndürülenler

Hashtable

için Hashtableeşitlenmiş (iş parçacığı güvenli) sarmalayıcı.

Özel durumlar

ArgumentNullException

table, null'e eşittir.

Örnekler

Aşağıdaki örnekte, bir Hashtableöğesinin eşitlenip eşitlenmediğini Hashtable belirleme ve eşitlenmiş Hashtablebir kullanma gösterilmektedir.

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.

Açıklamalar

Synchronized yöntemi, birden çok okuyucu ve yazıcı için iş parçacığı güvenlidir. Ayrıca, eşitlenmiş sarmalayıcı aynı anda yalnızca bir yazar yazma olmasını sağlar.

Bir koleksiyonda numaralandırma, iş parçacığı açısından güvenli bir yordam değildir. Bir koleksiyon eşitlendiğinde bile, diğer iş parçacıkları yine de koleksiyonu değiştirebilir ve bu da numaralandırıcının bir özel durum oluşturmasına neden olur. Numaralandırma sırasında iş parçacığı güvenliğini garanti etmek için, tüm numaralandırma sırasında koleksiyonu kilitleyebilir veya diğer iş parçacıkları tarafından yapılan değişikliklerden kaynaklanan özel durumları yakalayabilirsiniz.

Aşağıdaki kod örneğinde, tüm numaralandırma sırasında kullanarak SyncRoot koleksiyonun nasıl kilitlenmesi gösterilmektedir:

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

Bu yöntem bir O(1) işlemdir.

Ayrıca bkz.

• IsSynchronized
• SyncRoot