Collection.Item[] Propriedade

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Obtém um elemento específico de um objeto Collection por posição ou por chave.

Sobrecargas

Item[Int32]	Obtém um elemento específico de um objeto Collection por posição ou por chave.
Item[Object]	Obtém um elemento específico de um objeto Collection por posição ou por chave.
Item[String]	Obtém um elemento específico de um objeto Collection por posição ou por chave.

Item[Int32]

Origem:

Collection.vb

Obtém um elemento específico de um objeto Collection por posição ou por chave.

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

Parâmetros

Index

Int32

Uma expressão numérica que especifica a posição de um elemento da coleção. Index deve ser um número entre 1 e o valor da propriedade Count da coleção. Ou (B) Uma expressão Object que especifica a posição ou a cadeia de caracteres de chave de um elemento da coleção.

Valor da propriedade

Object

Um elemento específico de um Collection objeto por posição ou por chave.

Exemplos

O exemplo a seguir usa a Item propriedade para recuperar uma referência a um objeto em uma coleção. Ele cria birthdays como um Collection objeto e recupera o objeto que representa o aniversário de Bill, usando a chave "Bill" como o Index argumento .

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 a primeira chamada especifica explicitamente a Item propriedade , mas a segunda não. Ambas as chamadas funcionam porque a Item propriedade é a propriedade padrão de um Collection objeto .

Comentários

Se Index for do tipo Object, a Item propriedade tentará tratá-la como um Stringvalor , Char, Char matriz ou inteiro. Se Item não for possível converter Index em String ou Integer, ele gerará uma exceção ArgumentException .

A Item propriedade é a propriedade padrão de uma coleção. Portanto, as linhas de código a seguir são equivalentes.

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

Item[Object]

Origem:

Collection.vb

Obtém um elemento específico de um objeto Collection por posição ou por chave.

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

Parâmetros

Index

Object

Uma expressão numérica que especifica a posição de um elemento da coleção. Index deve ser um número entre 1 e o valor da propriedade Count da coleção. Ou (B) Uma expressão Object que especifica a posição ou a cadeia de caracteres de chave de um elemento da coleção.

Valor da propriedade

Object

Um elemento específico de um Collection objeto por posição ou por chave.

Exemplos

O exemplo a seguir usa a Item propriedade para recuperar uma referência a um objeto em uma coleção. Ele cria birthdays como um Collection objeto e recupera o objeto que representa o aniversário de Bill, usando a chave "Bill" como o Index argumento .

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 a primeira chamada especifica explicitamente a Item propriedade , mas a segunda não. Ambas as chamadas funcionam porque a Item propriedade é a propriedade padrão de um Collection objeto .

Comentários

Se Index for do tipo Object, a Item propriedade tentará tratá-la como um Stringvalor , Char, Char matriz ou inteiro. Se Item não for possível converter Index em String ou Integer, ele gerará uma exceção ArgumentException .

A Item propriedade é a propriedade padrão de uma coleção. Portanto, as linhas de código a seguir são equivalentes.

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

Item[String]

Origem:

Collection.vb

Obtém um elemento específico de um objeto Collection por posição ou por chave.

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

Parâmetros

Key

String

Uma expressão String exclusiva, que especifica uma cadeia de caracteres chave que pode ser usada, em vez de um índice posicional, para acessar um elemento da coleção. Key deve corresponder ao argumento Key especificado quando o elemento foi adicionado à coleção.

Valor da propriedade

Object

Um elemento específico de um Collection objeto por posição ou por chave.

Exemplos

O exemplo a seguir usa a Item propriedade para recuperar uma referência a um objeto em uma coleção. Ele cria birthdays como um Collection objeto e recupera o objeto que representa o aniversário de Bill, usando a chave "Bill" como o Index argumento .

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 a primeira chamada especifica explicitamente a Item propriedade , mas a segunda não. Ambas as chamadas funcionam porque a Item propriedade é a propriedade padrão de um Collection objeto .

Comentários

Se Index for do tipo Object, a Item propriedade tentará tratá-la como um Stringvalor , Char, Char matriz ou inteiro. Se Item não for possível converter Index em String ou Integer, ele gerará uma exceção ArgumentException .

A Item propriedade é a propriedade padrão de uma coleção. Portanto, as linhas de código a seguir são equivalentes.

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