Proprietà Item (oggetto Collection)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce un elemento specifico di un oggetto Collection per posizione o per chiave. Di sola lettura.

Default Public ReadOnly Property Item( _
    ByVal { Key As String | Index As Integer | Index As Object } _
) As Object

Parametri

Key
Espressione String univoca che consente di specificare una stringa chiave da utilizzare in sostituzione di un indice di posizione per accedere a un elemento dell'insieme. Key deve corrispondere all'argomento Key specificato durante l'aggiunta dell'elemento all'insieme.
Index
(A) Espressione numerica che consente di specificare la posizione di un elemento dell'insieme. Index deve essere un numero compreso tra 1 e il valore della Proprietà Count (oggetto Collection) dell'insieme. Oppure (B) Espressione Object che specifica la posizione o la stringa chiave di un elemento dell'insieme.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	Il valore specificato in Key non è valido oppure non corrisponde ad alcun elemento esistente dell'insieme. Index non può essere interpretato come dati numerici o di tipo carattere.
IndexOutOfRangeException	9	Key è Nothing. Il valore specificato in Index non corrisponde a nessun elemento esistente dell'insieme.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Se Index è di tipo Object, la proprietà Item tenta di considerarlo come String, Char, una matrice Char o un valore integer. Se Item non è in grado di convertire Index in un valore String o Integer, viene generata un'eccezione ArgumentException.

Item è la proprietà predefinita degli insiemi. Le righe di codice seguenti sono pertanto equivalenti.

MsgBox(CStr(customers.Item(1)))
MsgBox(CStr(customers(1)))

Esempio

Nell'esempio riportato di seguito la proprietà Item viene utilizzata per recuperare un riferimento a un oggetto di un insieme. birthdays viene creato come un oggetto Collection e recupera l'oggetto che rappresenta il compleanno di Bill, utilizzando la chiave "Bill" come argomento Index.

Dim birthdays As New Collection()
birthdays.Add(New DateTime(2001, 1, 12), "Bill")
birthdays.Add(New DateTime(2001, 1, 13), "Joe")
birthdays.Add(New DateTime(2001, 1, 14), "Mike")
birthdays.Add(New DateTime(2001, 1, 15), "Pete")


...


Dim aBirthday As DateTime
aBirthday = birthdays.Item("Bill")
MsgBox(CStr(aBirthday))
aBirthday = birthdays("Bill")
MsgBox(CStr(aBirthday))

Si noti che la prima chiamata specifica in modo esplicito la proprietà Item, al contrario della seconda. Entrambe le chiamate hanno comunque esito positivo in quanto Item è la proprietà predefinita per un oggetto Collection.