Collection

Una Collection è una hash table ^{[nota 1]}, ossia una "tabella" in cui ad un dato, o più dati, è associata una chiave. La Collezione permette di accedere al suo contenuto usando una chiave, senza tener conto di un indice come è invece per i vettori negli array e nelle matrici. ^{[nota 2]}

Private miaCollezione As New Collection


Public Sub Form_Open()

 Dim primoValore As Byte
 Dim secondoValore As Integer

 primoValore = 64
 secondoValore = 4000

' Impostiamo i membri della "Collection" inserendo un valore e la corrispondente "Chiave":
 With miaCollezione
'           Valore    -    Chiave
   .add(primoValore, "primaChiave")
   .add(secondoValore, "secondaChiave")
   .add("terzoValore", "terzaChiave")
 End With

' Qualora si intenda creare in modo esplicito i membri della Collection attribuendo a ciascuno il valore con la rispettiva "Chiave", si procederà come segue:
' miaCollezione = ["primaChiave": "primoValore", "secondaChiave": "secondoValore", "terzaChiave": "terzoValore"]

End


Public Sub Button1_Click()

 Print miaCollezione["primaChiave"]   ' scrive in console : 64
 Print miaCollezione["secondaChiave"]   ' scrive in console: 4000
 Print miaCollezione["terzaChiave"]   ' scrive in console: terzoValore

End

Note

[1] Un hash table è una struttura dati usata per mettere in corrispondenza una data chiave con un dato valore. (cfr. wikipedia)

[2] Riportiamo di seguito quanto scritto dall'utente md9327 nel forum di Gambas-it.org: "La classe Collection gestisce una array indicizzato per chiave. Si può associare una colonna con un nome chiave. Questo oggetto è utile in quei casi in cui vogliamo identificare univocamente una colonna.".