NameValueCollection.Remove(String) Método

Definição

Namespace:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Origem:

NameValueCollection.cs

Remove as entradas com a chave especificada da instância de NameObjectCollectionBase.

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)

Parâmetros

name

String

A chave String da entrada a ser removida. A chave pode ser null.

Exceções

NotSupportedException

A coleção é somente leitura.

Comentários

Se o NameValueCollection não contiver um elemento com a chave especificada, o NameValueCollection permanecerá inalterado. Nenhuma exceção é gerada.

Se você especificar um null valor para o name parâmetro , uma entrada com uma null chave será removida, se encontrada.

Em coleções de elementos contíguos, como listas, os elementos que seguem o elemento removido sobem para ocupar o ponto vazio. Caso a coleção seja indexada, os índices dos elementos que são movidos também são atualizados. Este comportamento não se aplica às coleções em que elementos sejam agrupados conceitualmente em buckets, como uma tabela de hash.

Este método é uma operação O(n), em que n é Count.

Confira também

• Executando operações de cadeia de caracteres que não levam em conta a cultura