NameValueCollection Construtores

Definição

Namespace:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Inicializa uma nova instância da classe NameValueCollection.

Sobrecargas

NameValueCollection()	Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial padrão e usa o provedor de código hash padrão que não diferencia maiúsculas e minúsculas e o comparador padrão que não diferencia maiúsculas de minúsculas.
NameValueCollection(IEqualityComparer)	Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial padrão e utiliza o objeto IEqualityComparer especificado.
NameValueCollection(NameValueCollection)	Copia as entradas do NameValueCollection especificado para um novo NameValueCollection com a mesma capacidade inicial que o número de entradas copiadas e usando o mesmo provedor de código hash e comparador que a coleção de origem.
NameValueCollection(Int32)	Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial especificada e usa o provedor de código hash e o comparador padrão que não diferenciam maiúsculas de minúsculas.
NameValueCollection(IHashCodeProvider, IComparer)	Obsoleto. Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial padrão e usa o provedor de código hash e o comparador especificados.
NameValueCollection(Int32, IEqualityComparer)	Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial especificada e usa o objeto IEqualityComparer especificado.
NameValueCollection(Int32, NameValueCollection)	Copia as entradas do NameValueCollection especificado para um novo NameValueCollection com a capacidade inicial especificada ou a mesma capacidade inicial que o número de entradas copiado, o que for maior, e usando o provedor padrão de código hash que não diferencia maiúsculas e minúsculas e o comparador padrão que não diferencia maiúsculas e minúsculas.
NameValueCollection(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe NameValueCollection, que pode ser serializada e usa o SerializationInfo e o StreamingContext especificados.
NameValueCollection(Int32, IHashCodeProvider, IComparer)	Obsoleto. Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial especificada e usa o provedor de código hash e o comparador especificados.

NameValueCollection()

Origem:

NameValueCollection.cs

Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial padrão e usa o provedor de código hash padrão que não diferencia maiúsculas e minúsculas e o comparador padrão que não diferencia maiúsculas de minúsculas.

public:
 NameValueCollection();

public NameValueCollection ();

Public Sub New ()

Comentários

A capacidade de um NameValueCollection é o número de elementos que o NameValueCollection pode conter. À medida que os elementos são adicionados a um NameValueCollection, a capacidade é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao NameValueCollection.

O provedor de código hash dispensa códigos de hash para chaves no NameValueCollection. O provedor de código hash padrão é o CaseInsensitiveHashCodeProvider.

O comparador determina se duas chaves são iguais. O comparador padrão é o CaseInsensitiveComparer.

Este construtor é uma operação O(1).

Confira também

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

NameValueCollection(IEqualityComparer)

Origem:

NameValueCollection.cs

Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial padrão e utiliza o objeto IEqualityComparer especificado.

public:
 NameValueCollection(System::Collections::IEqualityComparer ^ equalityComparer);

public NameValueCollection (System.Collections.IEqualityComparer? equalityComparer);

new System.Collections.Specialized.NameValueCollection : System.Collections.IEqualityComparer -> System.Collections.Specialized.NameValueCollection

Public Sub New (equalityComparer As IEqualityComparer)

Parâmetros

equalityComparer

IEqualityComparer

O objeto IEqualityComparer a ser usado para determinar se duas chaves são iguais e gerar códigos de hash para as chaves na coleção.

Comentários

A capacidade de um NameValueCollection objeto é o número de elementos que o NameValueCollection pode conter. À medida que os elementos são adicionados a um NameValueCollection, a capacidade é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao NameValueCollection.

O IEqualityComparer objeto combina o comparador e o provedor de código hash. O provedor de código hash dispensa códigos de hash para chaves no NameValueCollection. O comparador determina se duas chaves são iguais.

Este construtor é uma operação O(1).

Confira também

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

NameValueCollection(NameValueCollection)

Origem:

NameValueCollection.cs

Copia as entradas do NameValueCollection especificado para um novo NameValueCollection com a mesma capacidade inicial que o número de entradas copiadas e usando o mesmo provedor de código hash e comparador que a coleção de origem.

public:
 NameValueCollection(System::Collections::Specialized::NameValueCollection ^ col);

public NameValueCollection (System.Collections.Specialized.NameValueCollection col);

new System.Collections.Specialized.NameValueCollection : System.Collections.Specialized.NameValueCollection -> System.Collections.Specialized.NameValueCollection

Public Sub New (col As NameValueCollection)

Parâmetros

col

NameValueCollection

O NameValueCollection a ser copiado para a nova instância NameValueCollection.

Exceções

ArgumentNullException

col é null.

Comentários

A capacidade de um NameValueCollection é o número de elementos que o NameValueCollection pode conter. À medida que os elementos são adicionados a um NameValueCollection, a capacidade é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao NameValueCollection.

O provedor de código hash dispensa códigos de hash para chaves no NameValueCollection. O provedor de código hash padrão é o CaseInsensitiveHashCodeProvider.

O comparador determina se duas chaves são iguais. O comparador padrão é o CaseInsensitiveComparer.

Os elementos do novo NameValueCollection são classificados na mesma ordem que a origem NameValueCollection.

Esse construtor é uma operação O(n), em que n é o número de elementos em col.

Confira também

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

NameValueCollection(Int32)

Origem:

NameValueCollection.cs

Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial especificada e usa o provedor de código hash e o comparador padrão que não diferenciam maiúsculas de minúsculas.

public:
 NameValueCollection(int capacity);

public NameValueCollection (int capacity);

new System.Collections.Specialized.NameValueCollection : int -> System.Collections.Specialized.NameValueCollection

Public Sub New (capacity As Integer)

Parâmetros

capacity

Int32

O número inicial de entradas que o NameValueCollection pode conter.

Exceções

ArgumentOutOfRangeException

capacity é menor que zero.

Comentários

A capacidade de um NameValueCollection é o número de elementos que o NameValueCollection pode conter. À medida que os elementos são adicionados a um NameValueCollection, a capacidade é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao NameValueCollection.

O provedor de código hash dispensa códigos de hash para chaves no NameValueCollection. O provedor de código hash padrão é o CaseInsensitiveHashCodeProvider.

O comparador determina se duas chaves são iguais. O comparador padrão é o CaseInsensitiveComparer.

Esse construtor é uma operação O(n), em que n é capacity.

Confira também

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

NameValueCollection(IHashCodeProvider, IComparer)

Origem:

NameValueCollection.cs

Cuidado

This constructor has been deprecated. Use NameValueCollection(IEqualityComparer) instead.

Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial padrão e usa o provedor de código hash e o comparador especificados.

public:
 NameValueCollection(System::Collections::IHashCodeProvider ^ hashProvider, System::Collections::IComparer ^ comparer);

[System.Obsolete("This constructor has been deprecated. Use NameValueCollection(IEqualityComparer) instead.")]
public NameValueCollection (System.Collections.IHashCodeProvider? hashProvider, System.Collections.IComparer? comparer);

[<System.Obsolete("This constructor has been deprecated. Use NameValueCollection(IEqualityComparer) instead.")>]
new System.Collections.Specialized.NameValueCollection : System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameValueCollection

Public Sub New (hashProvider As IHashCodeProvider, comparer As IComparer)

Parâmetros

hashProvider

IHashCodeProvider

O IHashCodeProvider que fornecerá os códigos de hash para todas as chaves no NameValueCollection.

comparer

IComparer

O IComparer a ser usado para determinar se duas chaves são iguais.

Atributos

ObsoleteAttribute

Comentários

A capacidade de um NameValueCollection é o número de elementos que o NameValueCollection pode conter. À medida que os elementos são adicionados a um NameValueCollection, a capacidade é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao NameValueCollection.

O provedor de código hash dispensa códigos de hash para chaves no NameValueCollection. O provedor de código hash padrão é o CaseInsensitiveHashCodeProvider.

O comparador determina se duas chaves são iguais. O comparador padrão é o CaseInsensitiveComparer.

Este construtor é uma operação O(1).

Confira também

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

NameValueCollection(Int32, IEqualityComparer)

Origem:

NameValueCollection.cs

Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial especificada e usa o objeto IEqualityComparer especificado.

public:
 NameValueCollection(int capacity, System::Collections::IEqualityComparer ^ equalityComparer);

public NameValueCollection (int capacity, System.Collections.IEqualityComparer? equalityComparer);

new System.Collections.Specialized.NameValueCollection : int * System.Collections.IEqualityComparer -> System.Collections.Specialized.NameValueCollection

Public Sub New (capacity As Integer, equalityComparer As IEqualityComparer)

Parâmetros

capacity

Int32

O número inicial de entradas que o objeto NameValueCollection pode conter.

equalityComparer

IEqualityComparer

O objeto IEqualityComparer a ser usado para determinar se duas chaves são iguais e gerar códigos de hash para as chaves na coleção.

Exceções

ArgumentOutOfRangeException

capacity é menor que zero.

Comentários

A capacidade de um NameValueCollection objeto é o número de elementos que o NameValueCollection pode conter. À medida que os elementos são adicionados a um NameValueCollection, a capacidade é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao NameValueCollection.

O IEqualityComparer objeto combina o comparador e o provedor de código hash. O provedor de código hash dispensa códigos de hash para chaves no NameValueCollection. O comparador determina se duas chaves são iguais.

Esse construtor é uma operação O(n), em que n é o capacity parâmetro .

Confira também

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

NameValueCollection(Int32, NameValueCollection)

Origem:

NameValueCollection.cs

Copia as entradas do NameValueCollection especificado para um novo NameValueCollection com a capacidade inicial especificada ou a mesma capacidade inicial que o número de entradas copiado, o que for maior, e usando o provedor padrão de código hash que não diferencia maiúsculas e minúsculas e o comparador padrão que não diferencia maiúsculas e minúsculas.

public:
 NameValueCollection(int capacity, System::Collections::Specialized::NameValueCollection ^ col);

public NameValueCollection (int capacity, System.Collections.Specialized.NameValueCollection col);

new System.Collections.Specialized.NameValueCollection : int * System.Collections.Specialized.NameValueCollection -> System.Collections.Specialized.NameValueCollection

Public Sub New (capacity As Integer, col As NameValueCollection)

Parâmetros

capacity

Int32

O número inicial de entradas que o NameValueCollection pode conter.

col

NameValueCollection

O NameValueCollection a ser copiado para a nova instância NameValueCollection.

Exceções

ArgumentOutOfRangeException

capacity é menor que zero.

ArgumentNullException

col é null.

Comentários

A capacidade de um NameValueCollection é o número de elementos que o NameValueCollection pode conter. À medida que os elementos são adicionados a um NameValueCollection, a capacidade é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao NameValueCollection.

O provedor de código hash dispensa códigos de hash para chaves no NameValueCollection. O provedor de código hash padrão é o CaseInsensitiveHashCodeProvider.

O comparador determina se duas chaves são iguais. O comparador padrão é o CaseInsensitiveComparer.

Esse construtor é uma operação O(n), em que n é capacity. Se o número de elementos em col for maior que capacity, esse construtor se tornará uma operação O(nm + ), em n que é capacity e m é o número de elementos em col.

Confira também

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

NameValueCollection(SerializationInfo, StreamingContext)

Origem:

NameValueCollection.cs

Cuidado

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma nova instância da classe NameValueCollection, que pode ser serializada e usa o SerializationInfo e o StreamingContext especificados.

protected:
 NameValueCollection(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected NameValueCollection (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Collections.Specialized.NameValueCollection : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Collections.Specialized.NameValueCollection

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info

SerializationInfo

Um objeto SerializationInfo que contém as informações necessárias para serializar a nova instância NameValueCollection.

context

StreamingContext

Um objeto StreamingContext que contém a origem e o destino do fluxo serializado associado à nova instância NameValueCollection.

Atributos

ObsoleteAttribute

Comentários

Este construtor é uma operação O(1).

Confira também

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

NameValueCollection(Int32, IHashCodeProvider, IComparer)

Origem:

NameValueCollection.cs

Cuidado

This constructor has been deprecated. Use NameValueCollection(Int32, IEqualityComparer) instead.

Inicializa uma nova instância da classe NameValueCollection que está vazia, tem a capacidade inicial especificada e usa o provedor de código hash e o comparador especificados.

public:
 NameValueCollection(int capacity, System::Collections::IHashCodeProvider ^ hashProvider, System::Collections::IComparer ^ comparer);

[System.Obsolete("This constructor has been deprecated. Use NameValueCollection(Int32, IEqualityComparer) instead.")]
public NameValueCollection (int capacity, System.Collections.IHashCodeProvider? hashProvider, System.Collections.IComparer? comparer);

[<System.Obsolete("This constructor has been deprecated. Use NameValueCollection(Int32, IEqualityComparer) instead.")>]
new System.Collections.Specialized.NameValueCollection : int * System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameValueCollection

Public Sub New (capacity As Integer, hashProvider As IHashCodeProvider, comparer As IComparer)

Parâmetros

capacity

Int32

O número inicial de entradas que o NameValueCollection pode conter.

hashProvider

IHashCodeProvider

O IHashCodeProvider que fornecerá os códigos de hash para todas as chaves no NameValueCollection.

comparer

IComparer

O IComparer a ser usado para determinar se duas chaves são iguais.

Atributos

ObsoleteAttribute

Exceções

ArgumentOutOfRangeException

capacity é menor que zero.

Comentários

A capacidade de um NameValueCollection é o número de elementos que o NameValueCollection pode conter. À medida que os elementos são adicionados a um NameValueCollection, a capacidade é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao NameValueCollection.

O provedor de código hash distribui códigos hash para chaves no NameValueCollection. O provedor de código hash padrão é o CaseInsensitiveHashCodeProvider.

O comparador determina se duas chaves são iguais. O comparador padrão é o CaseInsensitiveComparer.

Esse construtor é uma operação O(n), em que n é capacity.

Confira também

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