HttpHeaders.Add Metodo

Definizione

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
Origine:
HttpHeaders.cs
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);
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

Il nome non può essere null o vuoto.

I valori non possono essere null o vuoti.

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.

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.

Si applica a

Add(String, String)

Origine:
HttpHeaders.cs
Origine:
HttpHeaders.cs
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);
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

Il nome non può essere null o vuoto.

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.

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.

Si applica a