Queue.Synchronized(Queue) Méthode

Définition

Espace de noms:

System.Collections

Assembly:

mscorlib.dll

Retourne un nouveau Queue qui encapsule la file d’attente d’origine et est thread-safe.

public:
 static System::Collections::Queue ^ Synchronized(System::Collections::Queue ^ queue);

public static System.Collections.Queue Synchronized(System.Collections.Queue queue);

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

Public Shared Function Synchronized (queue As Queue) As Queue

Paramètres

queue

Queue

À Queue synchroniser.

Retours

Queue

Wrapper Queue synchronisé (thread safe).

Exceptions

ArgumentNullException

queue a la valeur null.

Exemples

L’exemple de code suivant montre comment verrouiller la collection à l’aide de l’énumération SyncRoot entière. Cette méthode est une O(1) opération.

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

L’exemple suivant montre comment synchroniser un Queue, déterminer si un Queue est synchronisé et utiliser un synchronisé Queue.

using System;
using System.Collections;

public class SamplesQueue
{
    public static void Main()
    {
        // Creates and initializes a new Queue.
        Queue myQ = new Queue();
        myQ.Enqueue("The");
        myQ.Enqueue("quick");
        myQ.Enqueue("brown");
        myQ.Enqueue("fox");

        // Creates a synchronized wrapper around the Queue.
        Queue mySyncdQ = Queue.Synchronized(myQ);

        // Displays the sychronization status of both Queues.
        Console.WriteLine("myQ is {0}.", myQ.IsSynchronized ? "synchronized" : "not synchronized");
        Console.WriteLine("mySyncdQ is {0}.", mySyncdQ.IsSynchronized ? "synchronized" : "not synchronized");
    }
}
/*
This code produces the following output.

myQ is not synchronized.
mySyncdQ is synchronized.
*/

Imports System.Collections

Public Class SamplesQueue    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new Queue.
        Dim myQ As New Queue()
        myQ.Enqueue("The")
        myQ.Enqueue("quick")
        myQ.Enqueue("brown")
        myQ.Enqueue("fox")
        
        ' Creates a synchronized wrapper around the Queue.
        Dim mySyncdQ As Queue = Queue.Synchronized(myQ)
        
        ' Displays the sychronization status of both Queues.
        Dim msg As String
        If myQ.IsSynchronized Then
            msg = "synchronized"
        Else
            msg = "not synchronized"
        End If
        Console.WriteLine("myQ is {0}.", msg)
        If mySyncdQ.IsSynchronized Then
            msg = "synchronized"
        Else
            msg = "not synchronized"
        End If
        Console.WriteLine("mySyncdQ is {0}.", msg)
    End Sub
End Class

' This code produces the following output.
' 
' myQ is not synchronized.
' mySyncdQ is synchronized.

Remarques

Le wrapper retourné par cette méthode verrouille la file d’attente avant l’exécution d’une opération afin qu’elle soit effectuée de manière thread-safe.

Pour garantir la sécurité du thread du Queue, toutes les opérations doivent être effectuées via ce wrapper uniquement.

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

Voir aussi

• IsSynchronized
• SyncRoot