HttpHeaders.Add Metodo

Definizione

Spazio dei nomi:

System.Net.Http.Headers

Assembly:

System.Net.Http.dll

Assembly:

netstandard.dll

Inserisce una nuova intestazione e i relativi valori nella raccolta HttpHeaders.

Overload

Add(String, IEnumerable<String>)	Aggiunge l'intestazione specificata e i valori relativi nella raccolta HttpHeaders.
Add(String, String)	Aggiunge l'intestazione specificata e il valore relativo nella raccolta HttpHeaders.

Add(String, IEnumerable<String>)

Aggiunge l'intestazione specificata e i valori relativi nella raccolta 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))

Parametri

name

String

Intestazione da aggiungere alla raccolta.

values

IEnumerable<String>

Elenco di valori dell'intestazione da aggiungere alla raccolta.

Eccezioni

ArgumentException

Il nome non può essere Null o vuoto.

ArgumentNullException

I valori non possono essere Null o vuoti.

InvalidOperationException

Nome dell'intestazione utilizzato in modo improprio. Verificare che le intestazioni delle richieste vengano usate con oggetti HttpRequestMessage, le intestazioni di risposta con oggetti HttpResponseMessage e le intestazioni del contenuto con oggetti HttpContent.

FormatException

Il formato del nome dell'intestazione non è valido.

-oppure-

I caratteri di nuova riga nei valori dell'intestazione devono essere seguiti da un carattere di spazio vuoto.

Commenti

L'intestazione values verrà analizzata e convalidata.

Se l'intestazione specificata non esiste, il Add metodo inserisce una nuova intestazione nell'elenco di coppie nome/valore di intestazione.

Se l'intestazione specificata è già presente, values viene aggiunto all'elenco delimitato da virgole di valori associati all'intestazione.

Add(String, String)

Aggiunge l'intestazione specificata e il valore relativo nella raccolta 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)

Parametri

name

String

Intestazione da aggiungere alla raccolta.

value

String

Contenuto dell'intestazione.

Eccezioni

ArgumentException

Il nome non può essere Null o vuoto.

InvalidOperationException

Nome dell'intestazione utilizzato in modo improprio. Verificare che le intestazioni delle richieste vengano usate con oggetti HttpRequestMessage, le intestazioni di risposta con oggetti HttpResponseMessage e le intestazioni del contenuto con oggetti HttpContent.

FormatException

Il formato del nome dell'intestazione non è valido.

-oppure-

I caratteri di nuova riga nei valori dell'intestazione devono essere seguiti da un carattere di spazio vuoto.

Commenti

L'intestazione value verrà analizzata e convalidata.

Se l'intestazione specificata non esiste, il Add metodo inserisce una nuova intestazione nell'elenco di coppie nome/valore di intestazione.

Se l'intestazione specificata è già presente, value viene aggiunto all'elenco delimitato da virgole di valori associati all'intestazione.