HttpListenerResponse.AddHeader(String, String) Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.HttpListener.dll

Zdroj:

HttpListenerResponse.cs

Přidá zadanou hlavičku a hodnotu do hlaviček HTTP pro tuto odpověď.

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

Název hlavičky HTTP, která se má nastavit.

value

String

Hodnota name záhlaví.

Výjimky

ArgumentNullException

name je null nebo prázdný řetězec ("").

ArgumentException

Není povoleno zadat hodnotu pro zadanou hlavičku.

-nebo-

name nebo value obsahuje neplatné znaky.

ArgumentOutOfRangeException

Pouze rozhraní .NET Framework a .NET Core verze 2.0 až 3.1: Délka value je větší než 65 535 znaků.

Příklady

Následující příklad kódu ukazuje přidání hlavičky pomocí této vlastnosti.

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

Poznámky

Volání této metody je ekvivalentní volání Set metody v kolekci vrácené Headers vlastností.

Pokud hlavička zadaná v name neexistuje, tato metoda vloží nové záhlaví do Headers kolekce vlastnosti. Pokud name je v kolekci přítomen, tato metoda nahradí existující hodnotu za value. Pokud chcete přidat hodnotu do existující hlavičky bez nahrazení existující hodnoty, použijte metodu AppendHeader .

Viz také

• HttpListener
• HttpListenerContext
• HttpListenerRequest
• WebHeaderCollection