Partilhar via


NameValueCollection.Remove(String) Método

Definição

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);
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

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.

Aplica-se a

Confira também