HttpResponse.AppendHeader(String, String) Metodo

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

Aggiunge un'intestazione HTTP al flusso di output.

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

public void AppendHeader (string name, string value);

member this.AppendHeader : string * string -> unit

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

Parametri

name

String

Nome dell'intestazione HTTP da aggiungere al flusso di output.

value

String

Stringa da accodare all'intestazione.

Eccezioni

HttpException

L'intestazione viene accodata dopo l'invio delle intestazioni HTTP.

Esempio

Nell'esempio seguente viene chiamato il AppendHeader metodo per aggiungere un'intestazione personalizzata all'oggetto HttpResponse inviato al client richiedente.

Response.AppendHeader("CustomAspNetHeader", "Value1");

Response.AppendHeader("CustomAspNetHeader", "Value1")

Commenti

Se si usa il AppendHeader metodo per inviare intestazioni specifiche della cache e allo stesso tempo usare il modello a oggetti della cache (Cache) per impostare i criteri della cache, le intestazioni di risposta HTTP relative alla memorizzazione nella cache (Cache-Control, Expires, Last-Modified, Pragmae Vary) potrebbero essere eliminate quando viene usato il modello a oggetti della cache. Questo comportamento consente ASP.NET di mantenere le impostazioni più restrittive. Si consideri ad esempio una pagina che include i controlli utente. Se tali controlli hanno criteri di cache in conflitto, verranno usati i criteri di cache più restrittivi. Se un controllo utente imposta l'intestazione "Cache-Control: Public" e un altro controllo utente imposta l'intestazione più restrittiva "Cache-Control: Private" tramite chiamate a SetCacheability, l'intestazione "Cache-Control: Private" verrà inviata con la risposta.

Per un elenco delle intestazioni HTTP/1.1 standard, vedere Definizioni dei campi di intestazione.