Collection.Item[] Propriedade

Definição

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Sobrecargas

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

Item[Int32]

Obtém um elemento específico de um Collection objeto 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 de 1 até o valor da propriedade da Count coleção. Ou (B) Uma Object expressão 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 argumento Index .

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 para um Collection objeto.

Comentários

Se Index for do tipoObject, a Item propriedade tentará tratá-la como um StringCharChar valor de matriz ou inteiro. Se Item não for possível converter IndexString ou Integergerar uma exceção ArgumentException .

A Item propriedade é a propriedade padrão para 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]

Obtém um elemento específico de um Collection objeto 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

Valor da propriedade

Object

Um elemento específico de um Collection objeto 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))

Comentários

A Item propriedade é a propriedade padrão para 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]

Obtém um elemento específico de um Collection objeto 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 exclusiva String que especifica uma cadeia de caracteres de chave que pode ser usada, em vez de um índice posicional, para acessar um elemento da coleção. Key deve corresponder ao Key argumento 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

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

Comentários

A Item propriedade é a propriedade padrão para 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

Comentários

Esta página foi útil?