HttpListenerResponse.AddHeader(String, String) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net

Zestaw:: System.Net.HttpListener.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Źródło:: HttpListenerResponse.cs

Źródło:: HttpListenerResponse.cs

Źródło:: HttpListenerResponse.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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 lub pusty null ciąg ("").

ArgumentException

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

-lub-

name lub value zawiera nieprawidłowe znaki.

ArgumentOutOfRangeException

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

Przykłady

Poniższy przykład kodu pokazuje 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 pliku name nie istnieje, ta metoda wstawia nowy nagłówek do Headers kolekcji właściwości. Jeśli name 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 .

Dotyczy