HttpHeaders.Add Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Origem:
- HttpHeaders.cs
- 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);public void Add (string name, System.Collections.Generic.IEnumerable<string?> values);member this.Add : string * seq<string> -> unitPublic 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
O nome não pode ser nulo ou vazio.
Os valores não podem ser nulos ou vazios.
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.
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.
Aplica-se a
Add(String, String)
- Origem:
- HttpHeaders.cs
- Origem:
- HttpHeaders.cs
- 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);public void Add (string name, string? value);member this.Add : string * string -> unitPublic 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
O nome não pode ser nulo ou vazio.
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.
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.
