Stack.Synchronized(Stack) 方法

public:
 static System::Collections::Stack ^ Synchronized(System::Collections::Stack ^ stack);

public static System.Collections.Stack Synchronized(System.Collections.Stack stack);

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

Public Shared Function Synchronized (stack As Stack) As Stack

參數

傳回

一個同步包裝器包裹 Stack.

例外狀況

範例

以下範例展示了如何同步 、 Stack判斷 a Stack 是否同步，以及使用同步 Stack。

using System;
using System.Collections;

public class SamplesStack
{
    public static void Main()
    {
        // Creates and initializes a new Stack.
        Stack myStack = new Stack();
        myStack.Push("The");
        myStack.Push("quick");
        myStack.Push("brown");
        myStack.Push("fox");

        // Creates a synchronized wrapper around the Stack.
        Stack mySyncdStack = Stack.Synchronized(myStack);

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

myStack is not synchronized.
mySyncdStack is synchronized.
*/

Imports System.Collections

Public Class SamplesStack    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new Stack.
        Dim myStack As New Stack()
        myStack.Push("The")
        myStack.Push("quick")
        myStack.Push("brown")
        myStack.Push("fox")
        
        ' Creates a synchronized wrapper around the Stack.
        Dim mySyncdStack As Stack = Stack.Synchronized(myStack)

        ' Displays the sychronization status of both Stacks.
        Dim msg As String
        If myStack.IsSynchronized Then
            msg = "synchronized"
        Else
            msg = "not synchronized"
        End If        
        Console.WriteLine("myStack is {0}.", msg)        
        If mySyncdStack.IsSynchronized Then
            msg = "synchronized"
        Else
            msg = "not synchronized"
        End If
        Console.WriteLine("mySyncdStack is {0}.", msg)
    End Sub
End Class

' This code produces the following output.
' 
' myStack is not synchronized.
' mySyncdStack is synchronized.

備註

為確保執行 Stack緒的安全，所有操作必須透過此包裝器完成。

透過集合列舉本質上不是安全線程的程式。 即使集合同步處理，其他線程仍然可以修改集合，這會導致列舉值擲回例外狀況。 若要保證列舉期間的線程安全性，您可以在整個列舉期間鎖定集合，或攔截其他線程所做的變更所產生的例外狀況。

以下程式碼範例展示了如何在整個列舉過程中使用鎖定 SyncRoot 集合。

Stack myCollection = new Stack();

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

Dim myCollection As New Stack()

SyncLock myCollection.SyncRoot
    For Each item As Object In myCollection
        ' Insert your code here.
    Next item
End SyncLock

此方法為操作 O(1) 。