Collection.Item[] Propriedade

Definição

Espaço de Nomes:: Microsoft.VisualBasic

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Sobrecargas

Name	Description
Item[Int32]	Obtém um elemento específico de um `Collection` objeto, seja por posição ou por tonalidade.
Item[Object]	Obtém um elemento específico de um `Collection` objeto, seja por posição ou por tonalidade.
Item[String]	Obtém um elemento específico de um `Collection` objeto, seja por posição ou por tonalidade.

Item[Int32]

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

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 de 1 até ao valor da propriedade da Count coleção. Ou (B) Uma Object expressão que especifica a posição ou cadeia de chave de um elemento da coleção.

Valor de Propriedade

Object

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

Exemplos

O exemplo seguinte utiliza a Item propriedade para recuperar uma referência a um objeto numa coleção. Cria birthdays como um Collection objeto e depois recupera o objeto que representa o aniversário do Bill, usando a chave "Bill" como 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))

Note-se 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.

Observações

Se Index for do tipo Object, a Item propriedade tenta tratá-la como um String, Char, Char array ou valor inteiro. Se Item não for possível converter Index em String ou Integer, lança uma ArgumentException exceção.

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

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

Aplica-se a

Item[Object]

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

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

Valor de Propriedade

Object

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

Exemplos

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

Observações

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

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

Aplica-se a

Item[String]

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

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 única String que especifica uma cadeia de chaves que pode ser usada, em vez de um índice posicional, para aceder a um elemento da coleção. Key deve corresponder ao Key argumento especificado quando o elemento foi adicionado à coleção.

Valor de Propriedade

Object

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

Exemplos

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

Observações

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

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

Aplica-se a

Comentários

Esta página foi útil?