HttpHeaders.Add Metodo

Definizione

Spazio dei nomi:

System.Net.Http.Headers

Assembly:

System.Net.Http.dll

Inserisce una nuova intestazione e i relativi valori nell'insieme HttpHeaders.

Overload

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

Add(String, IEnumerable<String>)

Origine:

HttpHeaders.cs

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

Parametri

name

String

Intestazione da aggiungere alla raccolta.

values

IEnumerable<String>

Elenco di valori di 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 improprio. Assicurarsi che le intestazioni delle richieste vengano usate con HttpRequestMessage, intestazioni di risposta con HttpResponseMessage e intestazioni di contenuto con oggetti HttpContent.

FormatException

Il formato del nome dell'intestazione non è valido.

-o-

Il formato del valore dell'intestazione non è valido per questo nome di intestazione oppure l'intestazione non supporta più valori.

Commenti

I nomi di intestazione vengono applicati per essere token HTTP validi, in cui un token viene definito come qualsiasi set di lettere, cifre o simboli ASCII del set di "!#$%&'*+-.^_`|~", che corrispondono alla definizione di RFC9110. I caratteri non ASCII non sono consentiti in un nome di intestazione.

L'intestazione values verrà analizzata e convalidata.

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

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

Add(String, String)

Origine:

HttpHeaders.cs

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

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 improprio. Assicurarsi che le intestazioni delle richieste vengano usate con HttpRequestMessage, intestazioni di risposta con HttpResponseMessage e intestazioni di contenuto con oggetti HttpContent.

FormatException

Il formato del nome dell'intestazione non è valido.

-o-

Il formato del valore dell'intestazione non è valido per questo nome di intestazione oppure l'intestazione non supporta più valori.

Commenti

I nomi di intestazione vengono applicati per essere token HTTP validi, in cui un token viene definito come qualsiasi set di lettere, cifre o simboli ASCII del set di "!#$%&'*+-.^_`|~", che corrispondono alla definizione di RFC9110. I caratteri non ASCII non sono consentiti in un nome di intestazione.

L'intestazione values verrà analizzata e convalidata.

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

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