ArrayList.Synchronized Metodo

Definizione

Spazio dei nomi:

System.Collections

Assembly:

System.Runtime.dll

Restituisce un wrapper sincronizzato (thread-safe).

Overload

Synchronized(ArrayList)	Restituisce un wrapper ArrayList sincronizzato (thread-safe).
Synchronized(IList)	Restituisce un wrapper IList sincronizzato (thread-safe).

Synchronized(ArrayList)

Origine:

ArrayList.cs

Restituisce un wrapper ArrayList sincronizzato (thread-safe).

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

Parametri

list

ArrayList

Oggetto ArrayList da sincronizzare.

Restituisce

ArrayList

Wrapper ArrayList sincronizzato (thread-safe).

Eccezioni

ArgumentNullException

list è null.

Esempio

Nell'esempio di codice seguente viene illustrato come bloccare la raccolta usando durante SyncRoot l'intera enumerazione .

ArrayList^ myCollection = gcnew ArrayList();
bool lockTaken = false;
try
{
    Monitor::Enter(myCollection->SyncRoot, lockTaken);
    for each (Object^ item in myCollection);
    {
        // Insert your code here.
    }
}
finally
{
    if (lockTaken)
    {
        Monitor::Exit(myCollection->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

Questo metodo è un'operazione O(1) .

Nell'esempio di codice seguente viene illustrato come sincronizzare un ArrayListoggetto , determinare se un ArrayList oggetto è sincronizzato e usare un oggetto sincronizzato ArrayList.

using namespace System;
using namespace System::Collections;
int main()
{
   
   // Creates and initializes a new ArrayList instance.
   ArrayList^ myAL = gcnew 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.
   String^ szRes = myAL->IsSynchronized ?  (String^)"synchronized" :  "not synchronized";
   Console::WriteLine(  "myAL is {0}.", szRes );
   String^ szSyncRes = mySyncdAL->IsSynchronized ?  (String^)"synchronized" :  "not synchronized";
   Console::WriteLine(  "mySyncdAL is {0}.", szSyncRes );
}

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

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.

Commenti

Per garantire la thread safety di ArrayList, tutte le operazioni devono essere eseguite tramite questo wrapper.

L'enumerazione di una raccolta non è di per sé una procedura thread-safe. Anche se una raccolta è sincronizzata, è possibile che venga modificata da altri thread, con conseguente generazione di un'eccezione da parte dell'enumeratore. Per garantire la protezione dei thread durante l'enumerazione, è possibile bloccare la raccolta per l'intera enumerazione oppure intercettare le eccezioni determinate dalle modifiche apportate da altri thread.

Vedi anche

• SyncRoot
• IsSynchronized

Synchronized(IList)

Origine:

ArrayList.cs

Restituisce un wrapper IList sincronizzato (thread-safe).

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

Parametri

list

IList

Oggetto IList da sincronizzare.

Restituisce

IList

Wrapper IList sincronizzato (thread-safe).

Eccezioni

ArgumentNullException

list è null.

Esempio

Nell'esempio di codice seguente viene illustrato come bloccare la raccolta usando durante SyncRoot l'intera enumerazione .

ArrayList^ myCollection = gcnew ArrayList();
bool lockTaken = false;
try
{
    Monitor::Enter(myCollection->SyncRoot, lockTaken);
    for each (Object^ item in myCollection);
    {
        // Insert your code here.
    }
}
finally
{
    if (lockTaken)
    {
        Monitor::Exit(myCollection->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

Questo metodo è un'operazione O(1) .

Commenti

Per garantire la thread safety di ArrayList, tutte le operazioni devono essere eseguite tramite questo wrapper.

L'enumerazione di una raccolta non è di per sé una procedura thread-safe. Anche se una raccolta è sincronizzata, è possibile che venga modificata da altri thread, con conseguente generazione di un'eccezione da parte dell'enumeratore. Per garantire la protezione dei thread durante l'enumerazione, è possibile bloccare la raccolta per l'intera enumerazione oppure intercettare le eccezioni determinate dalle modifiche apportate da altri thread.

Vedi anche

• SyncRoot
• IsSynchronized