WebHeaderCollection Classe

Definição

Namespace:

System.Net

Assembly:

System.Net.WebHeaderCollection.dll

Origem:

WebHeaderCollection.cs

Contém os cabeçalhos de protocolo associados a uma solicitação ou resposta.

C#

public class WebHeaderCollection : System.Collections.Specialized.NameValueCollection, System.Runtime.Serialization.ISerializable

Herança

Object

NameObjectCollectionBase

NameValueCollection

WebHeaderCollection

Implementações

IEnumerable ISerializable

Comentários

A WebHeaderCollection classe geralmente é acessada por meio de WebRequest.Headers ou WebResponse.Headers.

No .NET Framework, alguns cabeçalhos comuns são considerados restritos e são expostos diretamente pela API (como Content-Type) ou protegidos pelo sistema e não podem ser alterados. Isso não se aplica ao .NET Core e ao .NET 5+, em que nenhum dos cabeçalhos é restrito.

Os cabeçalhos restritos são:

• Aceitar

• Conexão

• Content-Length

• Tipo de conteúdo

• Data

• Expect

• Host

• If-Modified-Since

• Intervalo

• Referer

• Transfer-Encoding

• User-Agent

• Proxy-Connection

Construtores

WebHeaderCollection()	Inicializa uma nova instância da classe WebHeaderCollection.
WebHeaderCollection(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe WebHeaderCollection das instâncias especificadas das classes SerializationInfo e StreamingContext.

Propriedades

AllKeys	Obtém todos os nomes de cabeçalho (chaves) na coleção.
Count	Obtém o número de cabeçalhos na coleção.
IsReadOnly	Obtém ou define um valor que indica se a instância de NameObjectCollectionBase é somente leitura. (Herdado de NameObjectCollectionBase)
Item[HttpRequestHeader]	Obtém ou define o cabeçalho de solicitação especificado.
Item[HttpResponseHeader]	Obtém ou define o cabeçalho de resposta especificado.
Item[Int32]	Obtém a entrada no índice especificado do NameValueCollection. (Herdado de NameValueCollection)
Item[String]	Obtém ou define a entrada com a chave especificada no NameValueCollection. (Herdado de NameValueCollection)
Keys	Obtém a coleção de nomes de cabeçalho (chaves) na coleção.

Métodos

Add(HttpRequestHeader, String)	Insere um cabeçalho especificado com o valor especificados na coleção.
Add(HttpResponseHeader, String)	Insere um cabeçalho especificado com o valor especificados na coleção.
Add(NameValueCollection)	Copia as entradas no NameValueCollection especificado para o NameValueCollection atual. (Herdado de NameValueCollection)
Add(String)	Insere o cabeçalho especificado na coleção.
Add(String, String)	Insere um cabeçalho com o nome e o valor especificados na coleção.
AddWithoutValidate(String, String)	Insere um cabeçalho na coleção sem verificar se o cabeçalho está na lista de cabeçalhos restritos.
BaseAdd(String, Object)	Adiciona uma entrada com a chave e o valor especificados à instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseClear()	Remove todas as entradas da instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGet(Int32)	Obtém o valor da entrada no índice especificado da instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGet(String)	Obtém o valor da primeira entrada com a chave especificada da instância de NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGetAllKeys()	Retorna uma matriz String que contém todas as chaves na instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGetAllValues()	Retorna uma matriz Object que contém todos os valores na instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGetAllValues(Type)	Retorna uma matriz do tipo especificado que contém todos os valores na instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGetKey(Int32)	Obtém a chave da entrada no índice especificado da instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseHasKeys()	Obtém um valor que indica se a instância NameObjectCollectionBase contém entradas cujas chaves não são null. (Herdado de NameObjectCollectionBase)
BaseRemove(String)	Remove as entradas com a chave especificada da instância de NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseRemoveAt(Int32)	Remove a entrada no índice especificado da instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseSet(Int32, Object)	Define o valor da entrada no índice especificado da instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseSet(String, Object)	Define o valor da primeira entrada com a chave especificada na instância NameObjectCollectionBase, se encontrada; caso contrário, adiciona uma entrada com a chave especificada e o valor para a instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
Clear()	Remove todos os cabeçalhos da coleção.
CopyTo(Array, Int32)	Copia todo o NameValueCollection em um Array unidimensional compatível, começando no índice especificado da matriz de destino. (Herdado de NameValueCollection)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Get(Int32)	Obtém o valor de dado cabeçalho na coleção, especificado por um índice na coleção.
Get(String)	Obtém o valor de um cabeçalho específico na coleção, especificado pelo nome do cabeçalho.
GetEnumerator()	Retorna um enumerador que pode ser iterado por meio da instância WebHeaderCollection.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetKey(Int32)	Obtém o nome de cabeçalho na posição especificada na coleção.
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValues(Int32)	Obtém uma matriz de valores de cabeçalho armazenados na posição index da coleção de cabeçalho.
GetValues(String)	Obtém uma matriz de valores de cabeçalho armazenados em um cabeçalho.
HasKeys()	Obtém um valor que indica se o NameValueCollection contém chaves que não são null. (Herdado de NameValueCollection)
InvalidateCachedArrays()	Redefine as matrizes em cache da coleção como null. (Herdado de NameValueCollection)
IsRestricted(String)	Testa se o cabeçalho HTTP especificado pode ser definido para a solicitação.
IsRestricted(String, Boolean)	Testa se o cabeçalho HTTP especificado pode ser definido para a solicitação ou a resposta.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDeserialization(Object)	Implementa a interface ISerializable e gera o evento de desserialização quando a desserialização for concluída.
Remove(HttpRequestHeader)	Remove o cabeçalho especificado da coleção.
Remove(HttpResponseHeader)	Remove o cabeçalho especificado da coleção.
Remove(String)	Remove o cabeçalho especificado da coleção.
Set(HttpRequestHeader, String)	Define o cabeçalho especificado para o valor especificado.
Set(HttpResponseHeader, String)	Define o cabeçalho especificado para o valor especificado.
Set(String, String)	Define o cabeçalho especificado para o valor especificado.
ToByteArray()	Converte o WebHeaderCollection em uma matriz de bytes.
ToString()	Esse método é obsoleto.

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Copia todo o NameObjectCollectionBase em um Array unidimensional compatível, começando no índice especificado da matriz de destino. (Herdado de NameObjectCollectionBase)
ICollection.IsSynchronized	Obtém um valor que indica se o acesso ao objeto NameObjectCollectionBase é sincronizado (thread-safe). (Herdado de NameObjectCollectionBase)
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao objeto NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Serializa esta instância para o objeto SerializationInfo especificado.

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Aplica-se a