ArrayList.Synchronized 方法

定義

命名空間:: System.Collections

組件:: mscorlib.dll, System.Collections.NonGeneric.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

回傳一個已同步（執行緒安全）的清單包裝器。

多載

名稱	Description
Synchronized(ArrayList)	傳回已同步處理 ArrayList 包裝函式（線程安全）。
Synchronized(IList)	傳回已同步處理 IList 包裝函式（線程安全）。

Synchronized(ArrayList)

傳回已同步處理 ArrayList 包裝函式（線程安全）。

public:
 static System::Collections::ArrayList ^ Synchronized(System::Collections::ArrayList ^ list);

public static System.Collections.ArrayList Synchronized(System.Collections.ArrayList list);

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

Public Shared Function Synchronized (list As ArrayList) As ArrayList

參數

list: ArrayList

那個 ArrayList 要同步的。

傳回

ArrayList

一個 ArrayList 同步（執行緒安全）的包裝器。

例外狀況

ArgumentNullException

list 是 null。

範例

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

ArrayList myCollection = new ArrayList();

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

Dim myCollection As New ArrayList()

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

此方法為操作 O(1) 。

以下程式碼範例說明如何同步 ArrayList，判斷是否 ArrayList 同步，並使用同步 ArrayList。

using System;
using System.Collections;
public class SamplesArrayList  {

   public static void Main()  {

      // Creates and initializes a new ArrayList.
      ArrayList myAL = new ArrayList();
      myAL.Add( "The" );
      myAL.Add( "quick" );
      myAL.Add( "brown" );
      myAL.Add( "fox" );

      // Creates a synchronized wrapper around the ArrayList.
      ArrayList mySyncdAL = ArrayList.Synchronized( myAL );

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

myAL is not synchronized.
mySyncdAL is synchronized.
*/

Imports System.Collections

Public Class SamplesArrayList
    
    
    Public Shared Sub Main()
        
        ' Creates and initializes a new ArrayList.
        Dim myAL As New ArrayList()
        myAL.Add("The")
        myAL.Add("quick")
        myAL.Add("brown")
        myAL.Add("fox")
        
        ' Creates a synchronized wrapper around the ArrayList.
        Dim mySyncdAL As ArrayList = ArrayList.Synchronized(myAL)
        
        ' Displays the sychronization status of both ArrayLists.
        Dim str As String
        If myAL.IsSynchronized Then
            str = "synchronized"
        Else
            str = "not synchronized"
        End If
        Console.WriteLine("myAL is {0}.", str)
        If mySyncdAL.IsSynchronized Then
            str = "synchronized"
        Else
            str = "not synchronized"
        End If
        Console.WriteLine("mySyncdAL is {0}.", str)
    End Sub
End Class

' This code produces the following output.
' 
' myAL is not synchronized.
' mySyncdAL is synchronized.

備註

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

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

另請參閱

適用於

Synchronized(IList)

傳回已同步處理 IList 包裝函式（線程安全）。

public:
 static System::Collections::IList ^ Synchronized(System::Collections::IList ^ list);

public static System.Collections.IList Synchronized(System.Collections.IList list);

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

Public Shared Function Synchronized (list As IList) As IList

參數

list: IList

那個 IList 要同步的。

傳回

IList

一個 IList 同步（執行緒安全）的包裝器。