Collection.Item, propriété (Int32)

Article
08/21/2007

Retourne un élément spécifique d'un objet Collection en fonction de sa position ou de sa clé. En lecture seule.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public ReadOnly Default Property Item ( _
    Index As Integer _
) As Object
'Utilisation
Dim instance As Collection
Dim Index As Integer
Dim value As Object

value = instance(Index)

public Object this [
    int Index
] { get; }

public:
property Object^ default [int] {
    Object^ get (int Index);
}

/** @property */
public Object get_Item (int Index)

J#  prend en charge l'utilisation de propriétés indexées mais pas la déclaration de nouvelles propriétés indexées.

Paramètres

Index
(A) Une expression numérique qui spécifie la position d'un élément de la collection. Index doit être un nombre entre 1 et la valeur de Count, propriété (objet Collection) de la collection. Ou (B) Une expression Object qui spécifie la position ou la chaîne clé d'un élément de la collection.

Valeur de la propriété

Retourne un élément spécifique d'un objet Collection en fonction de sa position ou de sa clé. En lecture seule.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Item, propriété (objet Collection).

Si Index est de type Object, la propriété Item tente de le traiter comme un tableau String, Char, Char ou une valeur d'entier. Si Item ne peut pas convertir Index en String ou Integer, il lève une exception ArgumentException.

La propriété Item est la propriété par défaut pour une collection. Par conséquent, les lignes de code suivantes sont équivalentes.

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

Exemple

L'exemple suivant utilise la propriété Item pour récupérer une référence à un objet dans une collection. Il crée birthdays en tant qu'objet Collection, puis récupère l'objet représentant l'anniversaire de Bill, à l'aide de la clé "Bill" comme argument 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))

Notez que le premier appel spécifie explicitement la propriété Item, mais que le second non. Les deux appels fonctionnent parce que la propriété Item est la propriété par défaut pour un objet Collection.

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Collection, classe
Membres Collection
Microsoft.VisualBasic, espace de noms

Autres ressources

Item, propriété (objet Collection)
Collection, objet (Visual Basic)
Add, méthode (objet Collection)
Count, propriété (objet Collection)
Remove, méthode (objet Collection)

Partager via