HttpListenerResponse.AppendHeader(String, String) Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.HttpListener.dll

Źródło:

HttpListenerResponse.cs

Dołącza wartość do określonego nagłówka HTTP, który ma być wysyłany z tą odpowiedzią.

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)

Parametry

name

String

Nazwa nagłówka HTTP do dołączenia value .

value

String

Wartość do dołączenia do nagłówka name .

Wyjątki

ArgumentException

name jest null lub pusty ciąg ("").

-lub-

Nie można określić wartości dla określonego nagłówka.

-lub-

name lub value zawiera nieprawidłowe znaki.

ArgumentOutOfRangeException

Tylko programy .NET Framework i .NET Core w wersji 2.0 – 3.1: długość value jest większa niż 65 535 znaków.

Uwagi

Wywołanie tej metody jest równoważne wywołaniu Add metody w kolekcji zwróconej Headers przez właściwość .

Jeśli nagłówek określony w header pliku nie istnieje, ta metoda wstawia nowy nagłówek do Headers kolekcji właściwości. Jeśli header element znajduje się w kolekcji, ta metoda dodaje value do istniejących wartości. Aby zastąpić wartość istniejącego nagłówka, użyj AddHeader metody .

Zobacz też

• HttpListener
• HttpListenerContext
• HttpListenerRequest