Compartilhar via


Collection.Item[] Propriedade

Definição

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
Origem:
Collection.vb
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; }
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

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)))  

Aplica-se a

Item[Object]

Origem:
Collection.vb
Origem:
Collection.vb
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; }
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

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)))  

Aplica-se a

Item[String]

Origem:
Collection.vb
Origem:
Collection.vb
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; }
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

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)))  

Aplica-se a