Queue.Synchronized(Queue) Metoda

Definicja

Przestrzeń nazw:

System.Collections

Zestawy:

netstandard.dll, System.Collections.NonGeneric.dll

Źródło:

Queue.cs

Zwraca nowy Queue element, który opakowuje oryginalną kolejkę i jest bezpieczny wątkiem.

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

Parametry

queue

Queue

Element Queue do synchronizacji.

Zwraca

Queue

Queue Zsynchronizowana otoka (bezpieczna wątkowa).

Wyjątki

ArgumentNullException

Parametr queue ma wartość null.

Przykłady

W poniższym przykładzie kodu pokazano, jak zablokować kolekcję przy użyciu SyncRoot elementu w trakcie całego wyliczenia. Ta metoda jest operacją O(1) .

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

W poniższym przykładzie pokazano, jak zsynchronizować element Queue, określić, czy Queue element jest zsynchronizowany, i używać zsynchronizowanego Queueelementu .

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.

Uwagi

Otoka zwrócona przez tę metodę blokuje kolejkę przed wykonaniem operacji, tak aby była wykonywana w bezpieczny wątkowo sposób.

Aby zagwarantować bezpieczeństwo wątków programu Queue, wszystkie operacje należy wykonać tylko za pomocą tej otoki.

Wyliczanie za pośrednictwem kolekcji nie jest wewnętrznie procedurą bezpieczną wątkowo. Nawet w przypadku synchronizacji kolekcji inne wątki nadal mogą modyfikować kolekcję, co powoduje zgłoszenie wyjątku przez moduł wyliczający. Aby zagwarantować bezpieczeństwo wątków podczas wyliczania, możesz zablokować kolekcję podczas całego wyliczenia lub przechwycić wyjątki wynikające ze zmian wprowadzonych przez inne wątki.

Zobacz też

• IsSynchronized
• SyncRoot