NameValueCollection.Remove(String) Methode

Definition

Entfernt die Einträge mit dem angegebenen Schlüssel aus der NameObjectCollectionBase-Instanz.

public:
 virtual void Remove(System::String ^ name);
public virtual void Remove (string name);
public virtual void Remove (string? name);
abstract member Remove : string -> unit
override this.Remove : string -> unit
Public Overridable Sub Remove (name As String)

Parameter

name
String

Der String-Schlüssel des zu entfernenden Eintrags. Der Schlüssel kann null sein.

Ausnahmen

Die Auflistung ist schreibgeschützt.

Hinweise

Wenn das NameValueCollection kein Element mit dem angegebenen Schlüssel enthält, bleibt der NameValueCollection unverändert. Es wird keine Ausnahme ausgelöst.

Wenn Sie einen null Wert für den name Parameter angeben, wird ein Eintrag mit einem null Schlüssel entfernt, falls er gefunden wird.

In Auflistungen mit zusammenhängenden Elementen, beispielsweise Listen, wird die nach dem Entfernen eines Elements entstandene Lücke durch Verschieben aller nachfolgenden Elemente gefüllt. Wenn die Auflistung indiziert ist, werden auch die Indizes der verschobenen Elemente aktualisiert. Dies gilt nicht für Auflistungen, in denen die Elemente konzeptionell in Buckets gruppiert sind, beispielsweise Hashtabellen.

Bei dieser Methode handelt es sich um einen O(n)-Vorgang, wobei n ist Count.

Gilt für:

Weitere Informationen