StringCollection.Remove(String) Método

Definição

Espaço de Nomes:
System.Collections.Specialized
Assemblagens:
System.dll, System.Collections.Specialized.dll
Assemblagens:
netstandard.dll, System.Collections.Specialized.dll
Assemblagem:
System.Collections.Specialized.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll
Origem:
StringCollection.cs
Origem:
StringCollection.cs
Origem:
StringCollection.cs
Origem:
StringCollection.cs
Origem:
StringCollection.cs

Remove a primeira ocorrência de uma cadeia específica do StringCollection.

public:
 void Remove(System::String ^ value);
public void Remove(string value);
public void Remove(string? value);
member this.Remove : string -> unit
Public Sub Remove (value As String)

Parâmetros

value
String

A cadeia a remover do StringCollection. O valor pode ser null.

Exemplos

O seguinte exemplo de código remove elementos do StringCollection.

using System;
using System.Collections;
using System.Collections.Specialized;

public class SamplesStringCollection  {

   public static void Main()  {

      // Creates and initializes a new StringCollection.
      StringCollection myCol = new StringCollection();
      String[] myArr = new String[] { "RED", "orange", "yellow", "RED", "green", "blue", "RED", "indigo", "violet", "RED" };
      myCol.AddRange( myArr );

      Console.WriteLine( "Initial contents of the StringCollection:" );
      PrintValues( myCol );

      // Removes one element from the StringCollection.
      myCol.Remove( "yellow" );

      Console.WriteLine( "After removing \"yellow\":" );
      PrintValues( myCol );

      // Removes all occurrences of a value from the StringCollection.
      int i = myCol.IndexOf( "RED" );
      while ( i > -1 )  {
         myCol.RemoveAt( i );
         i = myCol.IndexOf( "RED" );
      }

      Console.WriteLine( "After removing all occurrences of \"RED\":" );
      PrintValues( myCol );

      // Clears the entire collection.
      myCol.Clear();

      Console.WriteLine( "After clearing the collection:" );
      PrintValues( myCol );
   }

   public static void PrintValues( IEnumerable myCol )  {
      foreach ( Object obj in myCol )
         Console.WriteLine( "   {0}", obj );
      Console.WriteLine();
   }
}

/*
This code produces the following output.

Initial contents of the StringCollection:
   RED
   orange
   yellow
   RED
   green
   blue
   RED
   indigo
   violet
   RED

After removing "yellow":
   RED
   orange
   RED
   green
   blue
   RED
   indigo
   violet
   RED

After removing all occurrences of "RED":
   orange
   green
   blue
   indigo
   violet

After clearing the collection:

*/

Imports System.Collections
Imports System.Collections.Specialized

Public Class SamplesStringCollection   

   Public Shared Sub Main()

      ' Creates and initializes a new StringCollection.
      Dim myCol As New StringCollection()
      Dim myArr() As [String] = {"RED", "orange", "yellow", "RED", "green", "blue", "RED", "indigo", "violet", "RED"}
      myCol.AddRange(myArr)

      Console.WriteLine("Initial contents of the StringCollection:")
      PrintValues(myCol)

      ' Removes one element from the StringCollection.
      myCol.Remove("yellow")

      Console.WriteLine("After removing ""yellow"":")
      PrintValues(myCol)

      ' Removes all occurrences of a value from the StringCollection.
      Dim i As Integer = myCol.IndexOf("RED")
      While i > - 1
         myCol.RemoveAt(i)
         i = myCol.IndexOf("RED")
      End While

      Console.WriteLine("After removing all occurrences of ""RED"":")
      PrintValues(myCol)

      ' Clears the entire collection.
      myCol.Clear()

      Console.WriteLine("After clearing the collection:")
      PrintValues(myCol)

   End Sub

   Public Shared Sub PrintValues(myCol As IEnumerable)
      Dim obj As [Object]
      For Each obj In  myCol
         Console.WriteLine("   {0}", obj)
      Next obj
      Console.WriteLine()
   End Sub

End Class


'This code produces the following output.
'
'Initial contents of the StringCollection:
'   RED
'   orange
'   yellow
'   RED
'   green
'   blue
'   RED
'   indigo
'   violet
'   RED
'
'After removing "yellow":
'   RED
'   orange
'   RED
'   green
'   blue
'   RED
'   indigo
'   violet
'   RED
'
'After removing all occurrences of "RED":
'   orange
'   green
'   blue
'   indigo
'   violet
'
'After clearing the collection:
'

Observações

Cadeias duplicadas são permitidas em StringCollection. Apenas a primeira ocorrência é removida. Para remover todas as ocorrências da cadeia especificada, use RemoveAt(IndexOf(value)) repetidamente enquanto IndexOf não retorna -1.

Se o StringCollection não contiver o objeto especificado, o StringCollection permanece inalterado. Nenhuma exceção é lançada.

Em coleções de elementos contíguos, como listas, os elementos que seguem o elemento removido sobem para ocupar o local vago. Se a coleção for indexada, os índices dos elementos movidos também são atualizados. Este comportamento não se aplica a coleções onde os elementos são conceptualmente agrupados em baldes, como uma tabela de hash.

Este método determina a igualdade chamando Object.Equals. As comparações de cadeias são sensíveis às maiúsculas e minúsculas.

Este método realiza uma pesquisa linear; portanto, este método é uma operação O(n), onde n é Count.

Aplica-se a

Ver também