HttpHeaders.Add Método

Definição

Espaço de Nomes:: System.Net.Http.Headers

Assemblagem:: System.Net.Http.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Insere um novo cabeçalho e os seus valores na HttpHeaders coleção.

Sobrecargas

Name	Description
Add(String, IEnumerable<String>)	Adiciona o cabeçalho especificado e os seus valores à HttpHeaders coleção.
Add(String, String)	Adiciona o cabeçalho especificado e o seu valor à HttpHeaders coleção.

Add(String, IEnumerable<String>)

Adiciona o cabeçalho especificado e os seus valores à HttpHeaders coleção.

public:
 void Add(System::String ^ name, System::Collections::Generic::IEnumerable<System::String ^> ^ values);

public void Add(string name, System.Collections.Generic.IEnumerable<string> values);

member this.Add : string * seq<string> -> unit

Public Sub Add (name As String, values As IEnumerable(Of String))

Parâmetros

name: String

O cabeçalho para adicionar à coleção.

values: IEnumerable<String>

Uma lista de valores de cabeçalho para adicionar à coleção.

Exceções

ArgumentException

O nome não pode ser nulo ou vazio.

ArgumentNullException

Os valores não podem ser nulos ou vazios.

InvalidOperationException

Nome do cabeçalho mal utilizado. Certifique-se de que os cabeçalhos dos pedidos são usados com HttpRequestMessage, os cabeçalhos de resposta com HttpResponseMessage e os cabeçalhos de conteúdo com objetos HttpContent.

FormatException

O formato do nome do cabeçalho é inválido.

-ou-

O formato do valor do cabeçalho é inválido para este nome de cabeçalho, ou o cabeçalho não suporta múltiplos valores.

Observações

Os nomes dos cabeçalhos são obrigados a serem tokens HTTP válidos, onde um token é definido como qualquer conjunto de letras, dígitos ou símbolos ASCII do "!#$%&'*+-.^_`|~" conjunto, correspondendo à definição de RFC9110. Caracteres não ASCII não são permitidos num nome de cabeçalho.

O cabeçalho values será analisado e validado.

Se o cabeçalho especificado não existir, o Add método insere um novo cabeçalho na lista de pares nome/valor do cabeçalho.

Se o cabeçalho especificado já estiver presente, values são adicionados à lista separada por vírgulas de valores associados ao cabeçalho.

Aplica-se a

Add(String, String)

Adiciona o cabeçalho especificado e o seu valor à HttpHeaders coleção.

public:
 void Add(System::String ^ name, System::String ^ value);

public void Add(string name, string value);

member this.Add : string * string -> unit

Public Sub Add (name As String, value As String)