Collection.Item[] Propriété

Définition

Espace de noms:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Obtient un élément spécifique d’un objet Collection en fonction de sa position ou de sa clé.

Surcharges

Item[Int32]	Obtient un élément spécifique d’un objet Collection en fonction de sa position ou de sa clé.
Item[Object]	Obtient un élément spécifique d’un objet Collection en fonction de sa position ou de sa clé.
Item[String]	Obtient un élément spécifique d’un objet Collection en fonction de sa position ou de sa clé.

Item[Int32]

Source:

Collection.vb

Obtient un élément spécifique d’un objet Collection en fonction de sa position ou de sa clé.

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

public object? this[int Index] { get; }

member this.Item(int) : obj

Default Public ReadOnly Property Item(Index As Integer) As Object

Paramètres

Index

Int32

Expression numérique qui spécifie la position d'un élément de la collection. Index doit être un nombre compris entre 1 et la valeur de la propriété Count 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 propriété

Object

Élément spécifique d’un Collection objet par position ou par clé.

Exemples

L’exemple suivant utilise la Item propriété 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, en utilisant la clé "Bill" comme Index argument.

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 Item propriété, mais pas le second. Les deux appels fonctionnent, car la Item propriété est la propriété par défaut d’un Collection objet.

Remarques

Si Index est de type Object, la Item propriété tente de la traiter comme une Stringvaleur , , Char, Char ou entier. Si Item ne peut pas convertir en IndexString ou Integer, il lève une ArgumentException exception.

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

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

Item[Object]

Source:

Collection.vb

Obtient un élément spécifique d’un objet Collection en fonction de sa position ou de sa clé.

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

public object? this[object Index] { get; }

member this.Item(obj) : obj

Default Public ReadOnly Property Item(Index As Object) As Object

Paramètres

Index

Object

Expression numérique qui spécifie la position d'un élément de la collection. Index doit être un nombre compris entre 1 et la valeur de la propriété Count 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 propriété

Object

Élément spécifique d’un Collection objet par position ou par clé.

Exemples

L’exemple suivant utilise la Item propriété 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, en utilisant la clé "Bill" comme Index argument.

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 Item propriété, mais pas le second. Les deux appels fonctionnent, car la Item propriété est la propriété par défaut d’un Collection objet.

Remarques

Si Index est de type Object, la Item propriété tente de la traiter comme une Stringvaleur , , Char, Char ou entier. Si Item ne peut pas convertir en IndexString ou Integer, il lève une ArgumentException exception.

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

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

Item[String]

Source:

Collection.vb

Obtient un élément spécifique d’un objet Collection en fonction de sa position ou de sa clé.

public:
 property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ Key); };

public object? this[string Key] { get; }

member this.Item(string) : obj

Default Public ReadOnly Property Item(Key As String) As Object

Paramètres

Key

String

Expression String unique qui spécifie une chaîne clé qui peut être utilisée au lieu d'un index de position pour accéder à un élément de la collection. Key doit correspondre à l'argument Key spécifié lorsque l'élément a été ajouté à la collection.

Valeur de propriété

Object

Élément spécifique d’un Collection objet par position ou par clé.

Exemples

L’exemple suivant utilise la Item propriété 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, en utilisant la clé "Bill" comme Index argument.

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 Item propriété, mais pas le second. Les deux appels fonctionnent, car la Item propriété est la propriété par défaut d’un Collection objet.

Remarques

Si Index est de type Object, la Item propriété tente de la traiter comme une Stringvaleur , , Char, Char ou entier. Si Item ne peut pas convertir en IndexString ou Integer, il lève une ArgumentException exception.

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

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