Método Remove (Objeto Coleção)
Remove um elemento de um objeto Collection.
Public Overloads Sub Remove(_
ByVal { Key As String | Index As Integer } _
)
Parâmetros
Key
Um único String expressão que especifica uma chave em seqüência que pode ser usado, em vez de um índice posicional, para acesso um elemento da coleção. Key deve corresponder da Key argumento especificado quando o elemento foi adicionado à coleção.Index
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 coleção Propriedades de Contagem ( Objeto de coleção)..
Exceções
Tipo de exceção |
Número de erro |
Condição |
|---|---|---|
Key é inválida ou não especificada. |
||
Index não coincide com um elemento existente da coleção. |
Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.
Comentários
Quando Remove exclui um elemento de uma coleção, ele diminui um da Propriedades de Contagem ( Objeto de coleção). da coleção.Ela também diminui o valor Index de cada elemento que anteriormente seguia o elemento excluído na coleção.
Se um elemento foi adicionado à coleção sem uma Key, você deve usar seu Index para removê-lo.
Exemplo
Este exemplo ilustra o uso do método Remove para remover objetos de uma Objetos de Coleção (Visual Basic) na variável birthdays.
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")
...
birthdays.Remove(1)
birthdays.Remove("Mike")
Seguindo as quatro chamadas para o método Add ,a propriedade Count contém 4, o elemnto "Bill" tem valor de índice 1, e o elemento "Pete" tem valor de índice 4.
Após a primeira chamada a Remove,Count é 3, o elemento "Bill" é excluído, e o elemento "Pete" possui valor de índice 3.
Após a segunda chamada a Remove,Count é 2, o elemento "Mike" é excluído, e o elemento "Pete" possui valor de índice 2.
Requisitos
Namespace: Microsoft.VisualBasic
**Módulo:**Collection
Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)