HttpHeaders.Add Método

Definição

Namespace:

System.Net.Http.Headers

Assembly:

System.Net.Http.dll

Assembly:

netstandard.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 na coleção HttpHeaders.
Add(String, String)	Adiciona o cabeçalho especificado e seu valor na coleção HttpHeaders.

Add(String, IEnumerable<String>)

Adiciona o cabeçalho especificado e seus valores na 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);

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 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 utilizado incorretamente. Verifique se os cabeçalhos de solicitação 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 -

Caracteres de nova linha em valores de cabeçalho devem ser seguidos por um caractere de espaço em branco.

Comentários

O cabeçalho values será analisado e validado.

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

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

Add(String, String)

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

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

public void Add (string name, 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 utilizado incorretamente. Verifique se os cabeçalhos de solicitação 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 -

Caracteres de nova linha em valores de cabeçalho devem ser seguidos por um caractere de espaço em branco.

Comentários

O cabeçalho value será analisado e validado.

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

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