Hashtable.SyncRoot Eigenschaft

Definition

Namespace:

System.Collections

Assembly:

System.Runtime.dll

Quelle:

Hashtable.cs

Ruft ein Objekt ab, mit dem der Zugriff auf Hashtable synchronisiert werden kann.

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

public virtual object SyncRoot { get; }

member this.SyncRoot : obj

Public Overridable ReadOnly Property SyncRoot As Object

Eigenschaftswert

Object

Ein Objekt, mit dem der Zugriff auf Hashtable synchronisiert werden kann.

Implementiert

SyncRoot

Hinweise

Verwenden Sie die HashtableSynchronized -Methode, um eine synchronisierte Version von zu erstellen. Abgeleitete Klassen können jedoch mithilfe der SyncRoot -Eigenschaft eine eigene synchronisierte Version von Hashtable bereitstellen. Der Synchronisierungscode muss Vorgänge für den SyncRoot von Hashtableausführen, nicht direkt für .Hashtable Dies gewährleistet die einwandfreie Funktion von Auflistungen, die von anderen Objekten abgeleitet sind. Insbesondere wird eine ordnungsgemäße Synchronisierung mit anderen Threads beibehalten, die Hashtable das Objekt möglicherweise gleichzeitig ändern.

Das Aufzählen durch eine Sammlung ist intrinsisch keine threadsichere Prozedur. Selbst wenn eine Auflistung synchronisiert wird, besteht die Möglichkeit, dass andere Threads sie ändern. Dies führt dazu, dass der Enumerator eine Ausnahme auslöst. Um während der Enumeration Threadsicherheit zu gewährleisten, können Sie entweder die Auflistung während der gesamten Enumeration sperren oder die Ausnahmen, die aus von anderen Threads stammenden Änderungen resultieren, abfangen.

Im folgenden Codebeispiel wird gezeigt, wie die Auflistung während der gesamten Enumeration mit gesperrt SyncRoot wird:

Hashtable^ myCollection = gcnew Hashtable();
bool lockTaken = false;

try
{
    Monitor::Enter(myCollection->SyncRoot, lockTaken);
    for each (Object^ item in myCollection)
    {
        // Insert your code here.
    }
}
finally
{
    if (lockTaken)
    {
        Monitor::Exit(myCollection->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

Weitere Informationen

• IsSynchronized
• Synchronized(Hashtable)