Queue.SyncRoot Propriété

Définition

Obtient un objet qui peut être utilisé pour synchroniser l’accès à Queue.

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

Valeur de propriété

Objet qui peut être utilisé pour synchroniser l'accès à Queue.

Implémente

Exemples

L’exemple de code suivant montre comment verrouiller la collection à l’aide de pendant SyncRoot toute l’énumération. La récupération de la valeur de cette propriété est une O(1) opération.

Queue^ myCollection = gcnew Queue();
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);
    }
}
Queue myCollection = new Queue();
lock (myCollection.SyncRoot)
{
    foreach (object item in myCollection)
    {
        // Insert your code here.
    }
}
Dim myCollection As New Queue()
SyncLock myCollection.SyncRoot
    For Each item In myCollection
        ' Insert your code here.
    Next item
End SyncLock

Remarques

Pour créer une version synchronisée de , Queueutilisez la Synchronized méthode . Toutefois, les classes dérivées peuvent fournir leur propre version synchronisée du à l’aide Queue de la SyncRoot propriété . Le code de synchronisation doit effectuer des opérations sur le SyncRootQueuedu , pas directement sur le Queue. Cela garantit un bon fonctionnement des collections dérivées d’autres objets. Plus précisément, il maintient une synchronisation correcte avec d’autres threads qui peuvent modifier simultanément l’objet Queue .

L'énumération d'une collection n'est intrinsèquement pas une procédure thread-safe. Même lorsqu'une collection est synchronisée, les autres threads peuvent toujours la modifier, ce qui entraîne la levée d'une exception par l'énumérateur. Pour garantir la sécurité des threads au cours de l’énumération, vous pouvez verrouiller la collection pendant l’ensemble de l’énumération ou bien intercepter les exceptions résultant des modifications apportées par les autres threads.

S’applique à

Voir aussi