Item (Propiedad, objeto Collection)

Artículo
10/07/2008

Actualización: noviembre 2007

Devuelve un elemento concreto de un objeto Collection por posición o por clave. Sólo lectura.

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

Parámetros

Key
Expresión única String que especifica una cadena de clave que se puede utilizar, en lugar de un índice posicional, para tener acceso a un miembro de la colección. Key debe corresponder al argumento Key especificado cuando se agregó el elemento a la colección.
Index
(A) Expresión numérica que especifica la posición de un elemento de la colección. Index debe ser un número de 1 hasta el valor de Count (Propiedad, objeto Collection) de la colección. O (B) Expresión Object que especifica la posición o la cadena clave de un elemento de la colección.

Excepciones

Tipo de excepción	Número de error	Condición
ArgumentException	5	Key no es válido o no coincide con ningún elemento existente de la colección. Index no se puede interpretar como carácter o dato numérico.
IndexOutOfRangeException	9	Key es Nothing. Index no coincide con ningún elemento existente de la colección.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

Si Index es de tipo Object, la propiedad Item intenta tratarlo como matriz String, Char, Char o valor entero. Si Item no puede convertir Index en String o Integer, produce una excepción ArgumentException.

La propiedad Item es la propiedad predeterminada para una colección. Por tanto, las siguientes líneas de código son equivalentes.

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

Ejemplo

En el ejemplo siguiente se utiliza la propiedad Item para recuperar una referencia a un objeto de una colección. Crea birthdays como un objeto Collection y recupera después el objeto que representa el cumpleaños de Bill mediante la clave "Bill" como argumento 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))

Observe que la primera llamada especifica explícitamente la propiedad Item, pero no así la segunda. Ambas llamadas funcionan porque Item es la propiedad predeterminada de un objeto Collection.