NameValueCollection.Remove(String) NameValueCollection.Remove(String) NameValueCollection.Remove(String) NameValueCollection.Remove(String) Method

Definition

Entfernt die Einträge mit dem angegebenen Schlüssel aus der NameObjectCollectionBase-Instanz.Removes the entries with the specified key from the NameObjectCollectionBase instance.

public:
 virtual void Remove(System::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 String String String

Der String-Schlüssel des zu entfernenden Eintrags.The String key of the entry to remove. Der Schlüssel kann null sein.The key can be null.

Ausnahmen

Die Auflistung ist schreibgeschützt.The collection is read-only.

Hinweise

Wenn die NameValueCollection kein Element mit dem angegebenen Schlüssel enthält die NameValueCollection bleibt unverändert.If the NameValueCollection doesn't contain an element with the specified key, the NameValueCollection remains unchanged. Es werden keine Ausnahmen ausgelöst.No exception is thrown.

Bei Angabe einer null Wert der name -Parameter, einen Eintrag mit eine null Schlüssel entfernt, wenn gefunden.If you specify a null value to the name parameter, an entry with a null key is removed, if found.

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.In collections of contiguous elements, such as lists, the elements that follow the removed element move up to occupy the vacated spot. Wenn die Auflistung indiziert ist, werden auch die Indizes der verschobenen Elemente aktualisiert.If the collection is indexed, the indexes of the elements that are moved are also updated. Dies gilt nicht für Auflistungen, in denen die Elemente konzeptionell in Buckets gruppiert sind, beispielsweise Hashtabellen.This behavior does not apply to collections where elements are conceptually grouped into buckets, such as a hash table.

Diese Methode ist eine O (n)-Vorgang, in denen n ist Count.This method is an O(n) operation, where n is Count.

Gilt für:

Siehe auch