Collection.Item[] Propriété

Définition

Espace de noms:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

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

Surcharges

Nom Description
Item[Int32]

Obtient un élément spécifique d’un Collection objet par position ou par clé.
Item[Object]

Obtient un élément spécifique d’un Collection objet par position ou par clé.
Item[String]

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

Item[Int32]

Obtient un élément spécifique d’un Collection objet par position ou par 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é de Count la collection. Ou (B) Expression Object qui spécifie la position ou la chaîne de 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 d’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 la seconde. Les deux appels fonctionnent, car la Item propriété est la propriété par défaut d’un Collection objet.

Remarques

Si Index elle est de typeObject, la Item propriété tente de la traiter comme une valeur entière, CharChar un tableau ou un Stringtableau. Si Item elle ne peut pas être convertie Index en String ou Integer, elle 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)))

S’applique à

Item[Object]

Obtient un élément spécifique d’un Collection objet par position ou par 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é de Count la collection. Ou (B) Expression Object qui spécifie la position ou la chaîne de 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 d’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 la seconde. Les deux appels fonctionnent, car la Item propriété est la propriété par défaut d’un Collection objet.

Remarques

Si Index elle est de typeObject, la Item propriété tente de la traiter comme une valeur entière, CharChar un tableau ou un Stringtableau. Si Item elle ne peut pas être convertie Index en String ou Integer, elle 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)))

S’applique à

Item[String]

Obtient un élément spécifique d’un Collection objet par position ou par 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 unique String qui spécifie une chaîne de clé qui peut être utilisée, au lieu d’un index positionnel, pour accéder à un élément de la collection. Key doit correspondre à l’argument Key spécifié lors de l’ajout de l’élément à 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 d’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 la seconde. Les deux appels fonctionnent, car la Item propriété est la propriété par défaut d’un Collection objet.

Remarques

Si Index elle est de typeObject, la Item propriété tente de la traiter comme une valeur entière, CharChar un tableau ou un Stringtableau. Si Item elle ne peut pas être convertie Index en String ou Integer, elle 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)))

S’applique à