Teilen über


HttpListenerResponse.AddHeader(String, String) Methode

Definition

Fügt den HTTP-Headern für diese Antwort den angegebenen Header und Wert hinzu.

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)

Parameter

name
String

Der Name des festzulegenden HTTP-Headers.

value
String

Der Wert des name-Headers.

Ausnahmen

name ist null oder eine leere Zeichenfolge ("").

Sie sind nicht berechtigt, einen Wert für den angegebenen Header anzugeben.

- oder -

name oder value enthält ungültige Zeichen.

Nur .NET Framework und .NET Core, Versionen 2.0-3.1: value ist länger als 65.535 Zeichen.

Beispiele

Im folgenden Codebeispiel wird das Hinzufügen eines Headers mithilfe dieser Eigenschaft veranschaulicht.

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

Hinweise

Das Aufrufen dieser Methode entspricht dem Aufrufen der Set -Methode für die von der Headers -Eigenschaft zurückgegebene Auflistung.

Wenn der in name angegebene Header nicht vorhanden ist, fügt diese Methode einen neuen Header in die Auflistung der Headers Eigenschaft ein. Wenn name in der Auflistung vorhanden ist, ersetzt diese Methode den vorhandenen Wert durch value. Verwenden Sie die AppendHeader -Methode, um einem vorhandenen Header einen Wert hinzuzufügen, ohne den vorhandenen Wert zu ersetzen.

Gilt für:

Weitere Informationen