HttpListenerResponse.AddHeader(String, String) Metodo

Definizione

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

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

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

-oppure-

name oppure value contengono caratteri non validi.

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 .

Si applica a

Vedi anche