HttpListenerResponse.AddHeader(String, String) Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.HttpListener.dll

Origine:

HttpListenerResponse.cs

Aggiunge l'intestazione e il valore specificati alle intestazioni HTTP per questa risposta.

public:
 void AddHeader(System::String ^ name, System::String ^ value);

public void AddHeader (string name, string value);

member this.AddHeader : string * string -> unit

Public Sub AddHeader (name As String, value As String)

Parametri

name

String

Nome dell'intestazione HTTP da impostare.

value

String

Valore dell'intestazione name.

Eccezioni

ArgumentNullException

name è null o è una stringa vuota ("").

ArgumentException

Non è consentito specificare un valore per l'intestazione specificata.

-oppure-

name oppure value contengono caratteri non validi.

ArgumentOutOfRangeException

Solo .NET Framework e .NET Core versioni 2.0-3.1: la lunghezza di value è maggiore di 65.535 caratteri.

Esempio

Nell'esempio di codice seguente viene illustrata l'aggiunta di un'intestazione tramite questa proprietà.

public static void SetExpirationDate(long seconds, HttpListenerResponse response)
{
    response.AddHeader("Expires", seconds.ToString());
}

Public Shared Sub SetExpirationDate(ByVal seconds As Long, ByVal response As HttpListenerResponse)
    response.AddHeader("Expires", seconds.ToString())
End Sub

Commenti

La chiamata a questo metodo equivale a chiamare il Set metodo sulla raccolta restituita dalla Headers proprietà .

Se l'intestazione specificata in name non esiste, questo metodo inserisce una nuova intestazione nella Headers raccolta della proprietà. Se name è presente nella raccolta, questo metodo sostituisce il valore esistente con value. Per aggiungere un valore a un'intestazione esistente senza sostituire il valore esistente, utilizzare il AppendHeader metodo .

Vedi anche

• HttpListener
• HttpListenerContext
• HttpListenerRequest
• WebHeaderCollection