HttpListenerResponse.AddHeader(String, String) Metodo

Definizione

Aggiunge l'intestazione e il valore specificati alle intestazioni HTTP per questa risposta.Adds the specified header and value to the HTTP headers for this response.

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.The name of the HTTP header to set.

value
String

Valore dell'intestazione name.The value for the name header.

Eccezioni

name è null o è una stringa vuota ("").name is null or an empty string ("").

Non è consentito specificare un valore per l'intestazione specificata.You are not allowed to specify a value for the specified header.

-oppure--or- name oppure value contengono caratteri non validi.name or value contains invalid characters.

La lunghezza del parametro value è maggiore di 65.535 caratteri.The length of value is greater than 65,535 characters.

Esempio

Nell'esempio di codice riportato di seguito viene illustrata l'aggiunta di un'intestazione tramite questa proprietà.The following code example demonstrates adding a header using this property.

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 metodo Set sulla raccolta restituita dalla proprietà Headers.Calling this method is equivalent to calling the Set method on the collection returned by the Headers property.

Se l'intestazione specificata in name non esiste, questo metodo inserisce una nuova intestazione nella raccolta della proprietà Headers.If the header specified in name does not exist, this method inserts a new header into the Headers property's collection. Se name è presente nella raccolta, questo metodo sostituisce il valore esistente con value.If name is present in the collection, this method replaces the existing value with value. Per aggiungere un valore a un'intestazione esistente senza sostituire il valore esistente, usare il metodo AppendHeader.To add a value to an existing header without replacing the existing value, use the AppendHeader method.

Si applica a

Vedi anche