StringCollection.SyncRoot Egenskap

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

public object SyncRoot { get; }

member this.SyncRoot : obj

Public ReadOnly Property SyncRoot As Object

Egenskapsvärde

Ett objekt som kan användas för att synkronisera åtkomsten StringCollectiontill .

Implementeringar

Kommentarer

Härledda klasser kan tillhandahålla en egen synkroniserad version av egenskapen med hjälp SyncRoot av StringCollection egenskapen . Synkroniseringskoden måste utföra åtgärder på SyncRoot , StringCollectioninte direkt på StringCollection. Detta säkerställer korrekt drift av samlingar som härleds från andra objekt. Mer specifikt upprätthåller den korrekt synkronisering med andra trådar som kan ändra StringCollection objektet samtidigt.

Att räkna upp genom en samling är i sig inte en trådsäker procedur. Även när en samling synkroniseras kan andra trådar fortfarande ändra samlingen, vilket gör att uppräknaren genererar ett undantag. För att garantera trådsäkerheten under uppräkningen kan du antingen låsa samlingen under hela uppräkningen eller fånga undantagen från ändringar som gjorts av andra trådar.

Följande kodexempel visar hur du låser samlingen med hela SyncRoot uppräkningen:

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

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

Att hämta värdet för den här egenskapen är en O(1)-åtgärd.

Se även

• IsSynchronized