Metodo Remove (oggetto Collection)
Aggiornamento: novembre 2007
Rimuove un elemento da un oggetto Collection.
Public Overloads Sub Remove(_
ByVal { Key As String | Index As Integer } _
)
Parametri
Key
Espressione String univoca che consente di specificare una stringa chiave da utilizzare in sostituzione di un indice di posizione per accedere a un elemento dell'insieme. Key deve corrispondere all'argomento Key specificato durante l'aggiunta dell'elemento all'insieme.Index
Espressione numerica che consente di specificare la posizione di un elemento dell'insieme. Index deve essere un numero compreso tra 1 e il valore della Proprietà Count (oggetto Collection) dell'insieme.
Eccezioni
Tipo di eccezione |
Numero di errore |
Condizione |
---|---|---|
Key non è valido o non è stato specificato. |
||
Il valore specificato in Index non corrisponde a un elemento esistente dell'insieme. |
Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.
Note
Quando Remove elimina un elemento da un insieme, la Proprietà Count (oggetto Collection) dell'insieme viene ridotta di un'unità. Viene inoltre applicato un decremento al valore Index di ciascun elemento che precedeva l'elemento eliminato dall'insieme.
Se un elemento è stato aggiunto all'insieme senza una Key, per rimuoverlo sarà necessario utilizzarne il relativo Index.
Esempio
Nell'esempio seguente il metodo Remove viene utilizzato per rimuovere oggetti da un Oggetto Collection (Visual Basic) nella variabile 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")
In seguito alle quattro chiamate al metodo Add, la proprietà Count contiene 4, l'elemento "Bill" ha un valore di indice pari a 1 e l'elemento "Pete" ha un valore di indice pari a 4.
Dopo la prima chiamata a Remove, Count è uguale a 3, l'elemento "Bill" risulta eliminato e l'elemento "Pete" ha un valore di indice pari a 3.
Dopo la seconda chiamata a Remove, Count è uguale a 2, l'elemento "Mike" risulta eliminato e l'elemento "Pete" ha un valore di indice pari a 2.
Requisiti
Spazio dei nomi:Microsoft.VisualBasic
**Modulo:**Collection
**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)