HttpListenerResponse.AddHeader(String, String) Methode

Referenz

Definition

Namespace:: System.Net

Assembly:: System.Net.HttpListener.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: HttpListenerResponse.cs

Quelle:: HttpListenerResponse.cs

Quelle:: HttpListenerResponse.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

ArgumentNullException

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

ArgumentException

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

- oder -

name oder value enthält ungültige Zeichen.

ArgumentOutOfRangeException

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 Auflistung, die von der Headers -Eigenschaft zurückgegeben wird.

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: