NameValueCollection.Remove(String) Method

Reference

Definition

Namespace:: System.Collections.Specialized

Assemblies:: System.dll, System.Collections.Specialized.dll

Assemblies:: netstandard.dll, System.Collections.Specialized.dll

Assembly:: System.Collections.Specialized.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: NameValueCollection.cs

Source:: NameValueCollection.cs

Source:: NameValueCollection.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Removes the entries with the specified key from the NameObjectCollectionBase instance.

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)

Parameters

name: String

The String key of the entry to remove. The key can be null.

Exceptions

NotSupportedException

The collection is read-only.

Remarks

If the NameValueCollection doesn't contain an element with the specified key, the NameValueCollection remains unchanged. No exception is thrown.

If you specify a null value to the name parameter, an entry with a null key is removed, if found.

In collections of contiguous elements, such as lists, the elements that follow the removed element move up to occupy the vacated spot. If the collection is indexed, the indexes of the elements that are moved are also updated. This behavior does not apply to collections where elements are conceptually grouped into buckets, such as a hash table.

This method is an O(n) operation, where n is Count.

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1
UWP	10.0

Share via