Collection.Remove Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Remove um elemento de um Collection objeto.

Sobrecargas

Name Description
Remove(Int32)

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

Remove um elemento de um Collection objeto.

Remove(Int32)

Remove um elemento de um Collection objeto.

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 de 1 até ao valor da propriedade da Count 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 ao Add método, a Count propriedade contém 4, o elemento "Bill" tem valor de índice 1 e o elemento "Pete" tem valor de índice 4.

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

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

Observações

Quando Remove elimina um elemento de uma coleção, decremente a propriedade da Count coleção em um. Também diminui o Index valor de todos os elementos que anteriormente seguiram o elemento eliminado na coleção.

Se um elemento foi adicionado à coleção sem um Key, deve usar its Index para o remover.

Aplica-se a

Remove(String)

Remove um elemento de um Collection objeto.

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 única String que especifica uma cadeia de chaves que pode ser usada, em vez de um índice posicional, para aceder a um elemento da coleção. Key deve corresponder ao Key argumento 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 ao Add método, a Count propriedade contém 4, o elemento "Bill" tem valor de índice 1 e o elemento "Pete" tem valor de índice 4.

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

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

Observações

Quando Remove elimina um elemento de uma coleção, decremente a propriedade da Count coleção em um. Também diminui o Index valor de todos os elementos que anteriormente seguiram o elemento eliminado na coleção.

Se um elemento foi adicionado à coleção sem um Key, deve usar its Index para o remover.

Aplica-se a