Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe ArrayList

 

Data di pubblicazione: ottobre 2016

Implementa l'interfaccia IList usando una matrice la cui dimensione viene incrementata in modo dinamico in base alle esigenze.

Per esaminare il codice sorgente di .NET Framework per questo tipo, vedere il Reference Source.

Spazio dei nomi:   System.Collections
Assembly:  mscorlib (in mscorlib.dll)


[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ArrayList : IList, ICollection, IEnumerable, ICloneable

NomeDescrizione
System_CAPS_pubmethodArrayList()

Inizializza una nuova istanza della classe ArrayList vuota e con capacità iniziale predefinita.

System_CAPS_pubmethodArrayList(ICollection)

Inizializza una nuova istanza della classe ArrayList che contiene gli elementi copiati dalla raccolta specificata e ha la stessa capacità iniziale definita dal numero degli elementi copiati.

System_CAPS_pubmethodArrayList(Int32)

Inizializza una nuova istanza della classe ArrayList vuota e con capacità iniziale specificata.

NomeDescrizione
System_CAPS_pubpropertyCapacity

Ottiene o imposta il numero di elementi che ArrayList può contenere.

System_CAPS_pubpropertyCount

Ottiene il numero di elementi effettivamente contenuti nell'oggetto ArrayList.

System_CAPS_pubpropertyIsFixedSize

Ottiene un valore che indica se ArrayList ha dimensioni fisse.

System_CAPS_pubpropertyIsReadOnly

Ottiene un valore che indica se ArrayList è di sola lettura.

System_CAPS_pubpropertyIsSynchronized

Ottiene un valore che indica se l'accesso a ArrayList è sincronizzato (thread-safe).

System_CAPS_pubpropertyItem[Int32]

Ottiene o imposta l'elemento in corrispondenza dell'indice specificato.

System_CAPS_pubpropertySyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso a ArrayList.

NomeDescrizione
System_CAPS_pubmethodSystem_CAPS_staticAdapter(IList)

Crea un wrapper ArrayList per un oggetto IList specifico.

System_CAPS_pubmethodAdd(Object)

Aggiunge un oggetto alla fine di ArrayList.

System_CAPS_pubmethodAddRange(ICollection)

Aggiunge gli elementi di un oggetto ICollection alla fine di ArrayList.

System_CAPS_pubmethodBinarySearch(Int32, Int32, Object, IComparer)

Cerca un elemento in un intervallo di elementi nell'oggetto ArrayList ordinato usando l'operatore di confronto specificato e restituisce l'indice in base zero dell'elemento.

System_CAPS_pubmethodBinarySearch(Object)

Cerca un elemento nell'intero ArrayList ordinato usando l'operatore di confronto predefinito e restituisce l'indice in base zero dell'elemento.

System_CAPS_pubmethodBinarySearch(Object, IComparer)

Cerca un elemento nell'intero ArrayList ordinato usando l'operatore di confronto specificato e restituisce l'indice in base zero dell'elemento.

System_CAPS_pubmethodClear()

Rimuove tutti gli elementi da ArrayList.

System_CAPS_pubmethodClone()

Crea una copia superficiale di ArrayList.

System_CAPS_pubmethodContains(Object)

Determina se un elemento è incluso in ArrayList.

System_CAPS_pubmethodCopyTo(Array)

Copia l'intero oggetto ArrayList in un oggetto Array unidimensionale compatibile, a partire dall'inizio della matrice di destinazione.

System_CAPS_pubmethodCopyTo(Array, Int32)

Copia l'intero oggetto ArrayList in un oggetto Array compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione.

System_CAPS_pubmethodCopyTo(Int32, Array, Int32, Int32)

Copia una serie di elementi da ArrayList in un oggetto Array compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione.

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object.)

System_CAPS_pubmethodSystem_CAPS_staticFixedSize(ArrayList)

Restituisce un wrapper ArrayList di dimensioni fisse.

System_CAPS_pubmethodSystem_CAPS_staticFixedSize(IList)

Restituisce un wrapper IList di dimensioni fisse.

System_CAPS_pubmethodGetEnumerator()

Restituisce un enumeratore per l'intero ArrayList.

System_CAPS_pubmethodGetEnumerator(Int32, Int32)

Restituisce un enumeratore per un intervallo di elementi nell'oggetto ArrayList.

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetRange(Int32, Int32)

Restituisce ArrayList che rappresenta un subset di elementi nell'oggetto ArrayList di origine.

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodIndexOf(Object)

Cerca l'oggetto Object specificato e restituisce l'indice in base zero della prima occorrenza all'interno dell'intero ArrayList.

System_CAPS_pubmethodIndexOf(Object, Int32)

Cerca l'oggetto Object specificato e restituisce l'indice in base zero della prima occorrenza all'interno dell'intervallo di elementi dell'oggetto ArrayList compreso tra l'indice specificato e l'ultimo elemento.

System_CAPS_pubmethodIndexOf(Object, Int32, Int32)

Cerca l'oggetto Object specificato e restituisce l'indice in base zero della prima occorrenza all'interno dell'intervallo di elementi nell'oggetto ArrayList che inizia in corrispondenza dell'indice specificato e contiene il numero specificato di elementi.

System_CAPS_pubmethodInsert(Int32, Object)

Inserisce un elemento in ArrayList in corrispondenza dell'indice specificato.

System_CAPS_pubmethodInsertRange(Int32, ICollection)

Inserisce gli elementi di una raccolta in ArrayList in corrispondenza dell'indice specificato.

System_CAPS_pubmethodLastIndexOf(Object)

Cerca l'oggetto Object specificato e restituisce l'indice in base zero dell'ultima occorrenza all'interno dell'insieme ArrayList.

System_CAPS_pubmethodLastIndexOf(Object, Int32)

Cerca l'oggetto specificato Object e restituisce l'indice in base zero dell'ultima occorrenza all'interno dell'intervallo di elementi nella classe ArrayList che è compresa tra il primo elemento e l'indice specificato.

System_CAPS_pubmethodLastIndexOf(Object, Int32, Int32)

Cerca l'oggetto Object specificato e restituisce l'indice in base zero dell'ultima occorrenza all'interno dell'intervallo di elementi della classe ArrayList che contiene il numero specificato di elementi e termina in corrispondenza dell'indice specificato.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_pubmethodSystem_CAPS_staticReadOnly(ArrayList)

Restituisce un wrapper ArrayList di sola lettura.

System_CAPS_pubmethodSystem_CAPS_staticReadOnly(IList)

Restituisce un wrapper IList di sola lettura.

System_CAPS_pubmethodRemove(Object)

Rimuove la prima occorrenza di un oggetto specifico da ArrayList.

System_CAPS_pubmethodRemoveAt(Int32)

Rimuove l'elemento in corrispondenza dell'indice specificato di ArrayList.

System_CAPS_pubmethodRemoveRange(Int32, Int32)

Rimuove un intervallo di elementi da ArrayList.

System_CAPS_pubmethodSystem_CAPS_staticRepeat(Object, Int32)

Restituisce un ArrayList i cui elementi sono copie del valore specificato.

System_CAPS_pubmethodReverse()

Inverte l'ordine degli elementi nell'intero ArrayList.

System_CAPS_pubmethodReverse(Int32, Int32)

Inverte l'ordine degli elementi nell'intervallo specificato.

System_CAPS_pubmethodSetRange(Int32, ICollection)

Copia gli elementi di una raccolta in un intervallo di elementi nell'oggetto ArrayList.

System_CAPS_pubmethodSort()

Ordina gli elementi dell'intero oggetto ArrayList.

System_CAPS_pubmethodSort(IComparer)

Ordina gli elementi dell'intero ArrayList usando l'operatore di confronto specificato.

System_CAPS_pubmethodSort(Int32, Int32, IComparer)

Ordina gli elementi di un intervallo di elementi di ArrayList usando l'operatore di confronto specificato.

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(ArrayList)

Restituisce un wrapper ArrayList sincronizzato (thread-safe).

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(IList)

Restituisce un wrapper IList sincronizzato (thread-safe).

System_CAPS_pubmethodToArray()

Copia gli elementi di ArrayList in una nuova matrice Object.

System_CAPS_pubmethodToArray(Type)

Copia gli elementi di ArrayList in una nuova matrice del tipo di elemento specificato.

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object.)

System_CAPS_pubmethodTrimToSize()

Imposta la capacità sul numero effettivo di elementi contenuti in ArrayList.

NomeDescrizione
System_CAPS_pubmethodAsParallel()

Sottoposto a overload. Consente la parallelizzazione di una query.(Definito da ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Sottoposto a overload. Converte un IEnumerable a un IQueryable.(Definito da Queryable.)

System_CAPS_pubmethodCast<TResult>()

Esegue il cast di elementi di un IEnumerable nel tipo specificato.(Definito da Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtra gli elementi di un IEnumerable in base a un tipo specificato.(Definito da Enumerable.)

System_CAPS_noteNota

Per visualizzare il codice sorgente di .NET Framework per questo tipo, vedere il Reference Source. È possibile esplorare il codice sorgente online, scaricare i riferimenti per la visualizzazione offline e scorrere le origini (inclusi aggiornamenti e patch) durante l'esecuzione del debug. see instructions.

La ArrayList classe è progettata per contenere eterogenee raccolte di oggetti. Tuttavia, non sempre offre le migliori prestazioni. Al contrario, si consiglia quanto segue:

  • Per un insieme eterogeneo di oggetti, utilizzare il List<Object> (in c#) o List(Of Object) (in Visual Basic) digitare.

  • Per un insieme omogeneo degli oggetti, utilizzare la List<T> classe.

Vedere la sezione "Considerazioni sulle prestazioni" il List<T> argomento di riferimento per una discussione sulle prestazioni relative di queste classi.

Il ArrayList non è garantito da ordinare. È necessario ordinare il ArrayList chiamando relativo Sort metodo prima di eseguire le operazioni (ad esempio BinarySearch) che richiedono il ArrayList da ordinare. Per mantenere un insieme ordinato automaticamente man mano che vengono aggiunti nuovi elementi, è possibile utilizzare la SortedSet<T> classe.

La capacità di un ArrayList è il numero di elementi di ArrayList può contenere. Quando gli elementi vengono aggiunti a un ArrayList, la capacità viene aumentata automaticamente in base alle necessità, tramite riallocazione. È possibile diminuire la capacità chiamando TrimToSize o impostando la Capacity proprietà in modo esplicito.

Per grandi ArrayList oggetti, è possibile aumentare la capacità massima a 2 miliardi di elementi in un sistema a 64 bit impostando il enabled attributo dell'elemento di configurazione per true nell'ambiente di runtime.

Gli elementi in questa raccolta sono accessibile tramite un indice intero. Gli indici in questa raccolta sono in base zero.

Il ArrayList raccolta accetta null come valore valido. È possibile anche gli elementi duplicati.

Utilizzo di matrici multidimensionali come elementi in un ArrayList raccolta non è supportata.

Esempio di codice seguente viene illustrato come creare e inizializzare un ArrayList e come visualizzare i relativi valori.

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

   public static void Main()  {

      // Creates and initializes a new ArrayList.
      ArrayList myAL = new ArrayList();
      myAL.Add("Hello");
      myAL.Add("World");
      myAL.Add("!");

      // Displays the properties and values of the ArrayList.
      Console.WriteLine( "myAL" );
      Console.WriteLine( "    Count:    {0}", myAL.Count );
      Console.WriteLine( "    Capacity: {0}", myAL.Capacity );
      Console.Write( "    Values:" );
      PrintValues( myAL );
   }

   public static void PrintValues( IEnumerable myList )  {
      foreach ( Object obj in myList )
         Console.Write( "   {0}", obj );
      Console.WriteLine();
   }

}


/* 
This code produces output similar to the following:

myAL
    Count:    3
    Capacity: 4
    Values:   Hello   World   !

*/

Universal Windows Platform
Disponibile da 10
.NET Framework
Disponibile da 1.1

Statici pubblici (Shared in Visual Basic) di questo tipo sono thread-safe. I membri di istanza non sono garantiti come thread-safe.

Un ArrayList può supportare più lettori contemporaneamente, purché la raccolta non viene modificata. Per garantire la protezione dei thread di ArrayList, tutte le operazioni devono avvenire tramite il wrapper restituito dal Synchronized metodo.

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.

Torna all'inizio
Mostra: