HttpListenerResponse.AddHeader(String, String) Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.HttpListener.dll

Źródło:

HttpListenerResponse.cs

Dodaje określony nagłówek i wartość do nagłówków HTTP dla tej odpowiedzi.

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)

Parametry

name

String

Nazwa nagłówka HTTP do ustawienia.

value

String

Wartość nagłówka name .

Wyjątki

ArgumentNullException

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

ArgumentException

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.

Przykłady

Poniższy przykład kodu przedstawia dodawanie nagłówka przy użyciu tej właściwości.

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

Uwagi

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

Jeśli nagłówek określony w name pliku nie istnieje, ta metoda wstawia nowy nagłówek do Headers kolekcji właściwości. Jeśli name element znajduje się w kolekcji, ta metoda zastępuje istniejącą wartość wartością value. Aby dodać wartość do istniejącego nagłówka bez zastępowania istniejącej wartości, użyj AppendHeader metody .

Zobacz też

• HttpListener
• HttpListenerContext
• HttpListenerRequest
• WebHeaderCollection