HttpHeaders.Add Metodo

Definizione

Spazio dei nomi:: System.Net.Http.Headers

Assembly:: System.Net.Http.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Overload

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

Add(String, IEnumerable<String>)

Aggiunge l'intestazione specificata e i relativi valori nella HttpHeaders raccolta.

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.

oppure

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, 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 Add metodo 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)

Aggiunge l'intestazione specificata e il relativo valore nella HttpHeaders raccolta.

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)