HttpHeaders.Add Método

Definición

Espacio de nombres:

System.Net.Http.Headers

Ensamblado:

System.Net.Http.dll

Inserta un nuevo encabezado y sus valores en la colección HttpHeaders.

Sobrecargas

Add(String, IEnumerable<String>)	Agrega el encabezado especificado y sus valores a la colección HttpHeaders.
Add(String, String)	Agrega el encabezado especificado y su valor a la colección HttpHeaders.

Add(String, IEnumerable<String>)

Source:

HttpHeaders.cs

Agrega el encabezado especificado y sus valores a la colección 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

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

ArgumentException

El nombre no puede ser nulo ni estar vacío.

ArgumentNullException

Los valores no pueden ser null ni estar vacíos.

InvalidOperationException

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.

FormatException

El formato de nombre de encabezado no es válido.

-o-

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 de "!#$%&'*+-.^_`|~", que coincida con la 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 método Add inserta un nuevo encabezado en la lista de pares de nombre y valor de encabezado.

Si el encabezado especificado ya está presente, values se agregan a la lista separada por comas de valores asociados al encabezado.

Add(String, String)

Source:

HttpHeaders.cs

Agrega el encabezado especificado y su valor a la colección 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

Encabezado que se va a agregar a la colección.

value

String

Contenido del encabezado.

Excepciones

ArgumentException

El nombre no puede ser nulo ni estar vacío.

InvalidOperationException

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.

FormatException

El formato de nombre de encabezado no es válido.

-o-

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 de "!#$%&'*+-.^_`|~", que coincida con la 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 método Add inserta un nuevo encabezado en la lista de pares de nombre y valor de encabezado.

Si el encabezado especificado ya está presente, value se agrega a la lista separada por comas de valores asociados al encabezado.