HttpHeaders.Add Método

Definição

Namespace:

System.Net.Http.Headers

Assembly:

System.Net.Http.dll

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

Sobrecargas

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

Add(String, IEnumerable<String>)

Origem:

HttpHeaders.cs

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

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 a ser adicionado à coleção.

values

IEnumerable<String>

Uma lista de valores de cabeçalho a serem adicionados à 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. Verifique se os cabeçalhos de solicitação são usados com HttpRequestMessage, cabeçalhos de resposta com HttpResponseMessage e cabeçalhos de conteúdo com objetos HttpContent.

FormatException

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

-ou-

O formato de valor de cabeçalho é inválido para esse nome de cabeçalho ou o cabeçalho não dá suporte a vários valores.

Comentários

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

O cabeçalho values será analisado e validado.

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

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

Add(String, String)

Origem:

HttpHeaders.cs

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

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)

Parâmetros

name

String

O cabeçalho a ser adicionado à coleção.

value

String

O conteúdo do cabeçalho.

Exceções

ArgumentException

O nome não pode ser nulo ou vazio.

InvalidOperationException

Nome do cabeçalho mal utilizado. Verifique se os cabeçalhos de solicitação são usados com HttpRequestMessage, cabeçalhos de resposta com HttpResponseMessage e cabeçalhos de conteúdo com objetos HttpContent.

FormatException

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

-ou-

O formato de valor de cabeçalho é inválido para esse nome de cabeçalho ou o cabeçalho não dá suporte a vários valores.

Comentários

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

O cabeçalho values será analisado e validado.

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

Se o cabeçalho especificado já estiver presente, value será adicionado à lista separada por vírgulas de valores associados ao cabeçalho.