Collection.Remove Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Remove um elemento de um objeto Collection.

Sobrecargas

Remove(Int32)	Remove um elemento de um objeto Collection.
Remove(String)	Remove um elemento de um objeto Collection.

Remove(Int32)

Origem:

Collection.vb

Remove um elemento de um objeto Collection.

public:
 void Remove(int Index);

public void Remove (int Index);

member this.Remove : int -> unit

Public Sub Remove (Index As Integer)

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 entre 1 e o valor da propriedade Count da coleção.

Exemplos

Este exemplo ilustra o uso do Remove método para remover objetos de um Collection objeto 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")

Após as quatro chamadas para o Add método , a propriedade contém 4, o Count elemento "Bill" tem o valor de índice 1 e o elemento "Pete" tem o valor de índice 4.

Após a primeira chamada para Remove, Count é 3, o elemento "Bill" é excluído e o elemento "Pete" tem o valor de índice 3.

Após a segunda chamada para Remove, Count é 2, o elemento "Mike" é excluído e o elemento "Pete" tem o valor de índice 2.

Comentários

Quando Remove exclui um elemento de uma coleção, ele diminui a propriedade da Count coleção por um. Ele também diminui o Index valor de cada elemento que seguiu anteriormente o elemento excluído na coleção.

Se um elemento tiver sido adicionado à coleção sem um Key, você deverá usá-lo Index para removê-lo.

Remove(String)

Origem:

Collection.vb

Remove um elemento de um objeto Collection.

public:
 void Remove(System::String ^ Key);

public void Remove (string Key);

member this.Remove : string -> unit

Public Sub Remove (Key As String)

Parâ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.

Exemplos

Este exemplo ilustra o uso do Remove método para remover objetos de um Collection objeto 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")

Após as quatro chamadas para o Add método , a propriedade contém 4, o Count elemento "Bill" tem o valor de índice 1 e o elemento "Pete" tem o valor de índice 4.

Após a primeira chamada para Remove, Count é 3, o elemento "Bill" é excluído e o elemento "Pete" tem o valor de índice 3.

Após a segunda chamada para Remove, Count é 2, o elemento "Mike" é excluído e o elemento "Pete" tem o valor de índice 2.

Comentários

Quando Remove exclui um elemento de uma coleção, ele diminui a propriedade da Count coleção por um. Ele também diminui o Index valor de cada elemento que seguiu anteriormente o elemento excluído na coleção.

Se um elemento tiver sido adicionado à coleção sem um Key, você deverá usá-lo Index para removê-lo.