L’oggetto ArrayList è una collezione di elementi contentnti un singolo valore, consente di aggiungere, eliminare o visualizzare gli elementi della lista ed altre operazioni utili a gestire la strutura dati.
Fa parte del namespace
System.Collections (che deve essere importato quando vogliamo utilizzare l'oggetto in questione).
Proprietà
| Proprieta |
Descrizione |
| Capacity |
Il numero di elementi che può contenere. |
| Count |
Il numero di elementi contenuti. |
| IsFixedSize |
se ha dimensione fissa |
| IsReadOnly |
se è di sola scrittura. |
| IsSynchronized |
se l'accesso è sincronizzato (thread-safe). |
| Item |
Recupera o imposta l'elemento alla posizione specificata |
Metodi
| Proprieta |
Descrizione |
| Add |
Aggiunge un elemento |
| AddRange |
Aggiunge gli elementi di una ICollection alla fine dell'ArrayList. |
| BinarySearch |
Effettua una ricerca binaria sugli elementi |
| Clear |
Elimina gli elementi dell' ArrayList. |
| Clone |
Crea una copia dell'ArrayList. |
| Contains |
Determina de un elemento fa parte dell'ArrayList. |
| CopyTo |
Copia ArrayList in un array monodimensionale. |
| Equals |
Determina se due oggetti sono uguali |
| GetEnumerator |
Restituisce un enumerator che può iterare nell'ArrayList. |
| GetHashCode |
Ottiene il codice Hash. |
| GetRange |
Ottiene un subset degli elementi ArrayList. |
| IndexOf |
Restituisce l'indice della prima occorrenza del valore passato al metodo. |
| Insert |
Inserisce un elemento nella posizione specificata |
| InsertRange |
Inserisce gli elementi di una collection nella posizione specificata |
| LastIndexOf |
Restituisce l'indice dell'ultima occorrenza del valore passato al metodo. |
| Remove |
Elimina un elemento |
| RemoveAt |
Elimina un elemento nella posizione specificata |
| RemoveRange |
Elimina un range di elementi dall'ArrayList. |
| Reverse |
Ordina in senso inverso |
| Sort |
Ordian l'ArrayList |
| ToArray |
Copia i valori in un array. |
| ToString |
Restituisce una stringa che rappresenta l'oggetto |
| TrimToSize |
Imposta il valore di capacity al numero di elementi dell'ArrayList |
Esempi
Gli elementi vengono aggiunti tramite il metodo Add().
Nel seguente esempio creiamo un ArrayList chiamato myFriends e gli aggiungiamo tre elementi:
<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
if (!Page.IsPostBack)
{
ArrayList myFriends = new ArrayList();
myFriends.Add("Pippo");
myFriends.Add("Paperino");
myFriends.Add("Topolino");
}
}
</script>
Un ArrayList può essere ordinato alfabeticamente con il metodo Sort():
<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
if (!Page.IsPostBack)
{
ArrayList myFriends = new ArrayList();
myFriends.Add("Pippo");
myFriends.Add("Paperino");
myFriends.Add("Topolino");
myFriends.Sort();
}
}
</script>
O in modo inverso tramite il metodo Reverse() dopo il Sort():
<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
if (!Page.IsPostBack)
{
ArrayList myFriends = new ArrayList();
myFriends.Add("Pippo");
myFriends.Add("Paperino");
myFriends.Add("Topolino");
myFriens.Sort();
myFriends.Reverse();
}
}
</script>
Data Binding con gli ArrayList
Possiamo effettuare il databinding di un ArrayList con elementi come ad esempio una DropdownList
<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
if (!Page.IsPostBack)
{
ArrayList myFriends = new ArrayList();
myFriends.Add("Pippo");
myFriends.Add("Paperino");
myFriends.Add("Topolino");
myFriends.Sort();
ddlMyFriends.DataSource=myFriends;
ddlMyFriends.DataBind();
}
}
</script>
<html>
<body>
<form runat="server">
<asp:DropDownList id="ddlMyFriends" runat="server" />
</form>
</body>
</html>