HttpListenerResponse.AddHeader(String, String) Methode
Definition
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 -> unitPublic 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.
