StringCollection.Remove(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee verwijdert u het eerste exemplaar van een specifieke tekenreeks uit de 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)
Parameters
- value
- String
De tekenreeks die uit de StringCollectiontekenreeks moet worden verwijderd. De waarde kan zijn null.
Voorbeelden
In het volgende codevoorbeeld worden elementen uit de 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:
'
Opmerkingen
Dubbele tekenreeksen zijn toegestaan in StringCollection. Alleen de eerste instantie wordt verwijderd. Als u alle exemplaren van de opgegeven tekenreeks wilt verwijderen, gebruikt RemoveAt(IndexOf(value)) u herhaaldelijk terwijl IndexOf -1 niet wordt geretourneerd.
Als het StringCollection opgegeven object niet bevat, blijft het StringCollection ongewijzigd. Er wordt geen uitzondering opgeworpen.
In verzamelingen van aaneengesloten elementen, zoals lijsten, worden de elementen die volgen op het verwijderde element omhoog verplaatst om de onbezette plek te bezetten. Als de verzameling is geïndexeerd, worden de indexen van de verplaatste elementen ook bijgewerkt. Dit gedrag is niet van toepassing op verzamelingen waarin elementen conceptueel zijn gegroepeerd in buckets, zoals een hash-tabel.
Deze methode bepaalt gelijkheid door aan te roepen Object.Equals. Tekenreeksvergelijkingen zijn hoofdlettergevoelig.
Met deze methode wordt een lineaire zoekopdracht uitgevoerd; daarom is deze methode een O(n)-bewerking, waarbij n .Count