HttpHeaders.Add Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inserta un nuevo encabezado y sus valores en la HttpHeaders colección.
Sobrecargas
| Nombre | Description |
|---|---|
| Add(String, IEnumerable<String>) |
Agrega el encabezado especificado y sus valores a la HttpHeaders colección. |
| Add(String, String) |
Agrega el encabezado especificado y su valor a la HttpHeaders colección. |
Add(String, IEnumerable<String>)
Agrega el encabezado especificado y sus valores a la HttpHeaders colección.
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> -> unitPublic Sub Add (name As String, values As IEnumerable(Of String))Parámetros
- name
- String
Encabezado que se va a agregar a la colección.
- values
- IEnumerable<String>
Lista de valores de encabezado que se van a agregar a la colección.
Excepciones
El nombre no puede ser nulo ni estar vacío.
Los valores no pueden ser null ni estar vacíos.
Nombre de encabezado mal usado. Asegúrese de que los encabezados de solicitud se usan con HttpRequestMessage, encabezados de respuesta con HttpResponseMessage y encabezados de contenido con objetos HttpContent.
El formato de nombre de encabezado no es válido.
O bien
El formato de valor de encabezado no es válido para este nombre de encabezado o el encabezado no admite varios valores.
Comentarios
Los nombres de encabezado se aplican para que sean tokens HTTP válidos, donde un token se define como cualquier conjunto de letras, dígitos o símbolos ASCII del conjunto, que coincida "!#$%&'*+-.^_`|~" definición de RFC9110. No se permiten caracteres no ASCII en un nombre de encabezado.
El encabezado values se analizará y validará.
Si el encabezado especificado no existe, el Add método inserta un nuevo encabezado en la lista de pares nombre-valor de encabezado.
Si el encabezado especificado ya está presente, values se agregan a la lista separada por comas de valores asociados al encabezado.
Se aplica a
Add(String, String)
Agrega el encabezado especificado y su valor a la HttpHeaders colección.
public:
void Add(System::String ^ name, System::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
Encabezado que se va a agregar a la colección.
- value
- String
Contenido del encabezado.
Excepciones
El nombre no puede ser nulo ni estar vacío.
Nombre de encabezado mal usado. Asegúrese de que los encabezados de solicitud se usan con HttpRequestMessage, encabezados de respuesta con HttpResponseMessage y encabezados de contenido con objetos HttpContent.
El formato de nombre de encabezado no es válido.
O bien
El formato de valor de encabezado no es válido para este nombre de encabezado o el encabezado no admite varios valores.
Comentarios
Los nombres de encabezado se aplican para que sean tokens HTTP válidos, donde un token se define como cualquier conjunto de letras, dígitos o símbolos ASCII del conjunto, que coincida "!#$%&'*+-.^_`|~" definición de RFC9110. No se permiten caracteres no ASCII en un nombre de encabezado.
El encabezado values se analizará y validará.
Si el encabezado especificado no existe, el Add método inserta un nuevo encabezado en la lista de pares nombre-valor de encabezado.
Si el encabezado especificado ya está presente, value se agrega a la lista de valores separados por comas asociados al encabezado.