Remove (Método, objeto Collection)
Actualización: noviembre 2007
Elimina un elemento de un objeto Collection.
Public Overloads Sub Remove(_
ByVal { Key As String | Index As Integer } _
)
Parámetros
Key
Expresión única String que especifica una cadena de clave que se puede utilizar, en lugar de un índice posicional, para tener acceso a un miembro de la colección. Key debe corresponder al argumento Key especificado cuando se agregó el elemento a la colección.Index
Expresión numérica que especifica la posición de un elemento de la colección. Index debe ser un número de 1 hasta el valor de Count (Propiedad, objeto Collection) de la colección.
Excepciones
Tipo de excepción |
Número de error |
Condición |
|---|---|---|
Key no es válido o no se especifica. |
||
Index no coincide con ningún elemento existente de la colección. |
Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.
Comentarios
Cuando Remove elimina un elemento de una colección, disminuye el valor Count (Propiedad, objeto Collection) de la colección en uno. También disminuye el valor Index de cada elemento que seguía antes al elemento eliminado en la colección.
Si se agregara un elemento a la colección sin Key, se debe utilizar su Index para eliminarlo.
Ejemplo
En este ejemplo se ilustra el uso del método Remove para eliminar objetos de una Collection (Objeto, Visual Basic) en la variable 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")
Tras la cuarta llamada al método Add, la propiedad Count contiene 4, el elemento "Bill" tiene un valor de índice de 1 y el elemento "Pete", un valor de índice de 4.
Tras la primera llamada a Remove, Count tiene 3, el elemento "Bill" se elimina y el elemento "Pete" tiene un valor de índice de 3.
Tras la segunda llamada a Remove, Count tiene 2, el elemento "Mike" se elimina y el elemento "Pete" tiene un valor de índice de 2.
Requisitos
Espacio de nombres:Microsoft.VisualBasic
**Módulo:**Collection
**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)