Collection.Item[] Propriedade
Definição
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 objeto Collection por posição ou por chave.
Sobrecargas
| Item[Int32] |
Obtém um elemento específico de um objeto |
| Item[Object] |
Obtém um elemento específico de um objeto |
| Item[String] |
Obtém um elemento específico de um objeto |
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) : objDefault Public ReadOnly Property Item(Index As Integer) As ObjectParâ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) : objDefault Public ReadOnly Property Item(Index As Object) As ObjectParâ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) : objDefault Public ReadOnly Property Item(Key As String) As ObjectParâ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)))
