ArrayList.Synchronized 方法

定义

命名空间:: System.Collections

程序集:: mscorlib.dll, System.Collections.NonGeneric.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

返回已同步的列表包装器（线程安全）。

重载

名称	说明
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同步的包装器（线程安全）。

例外