HttpListenerResponse.AddHeader(String, String) Metoda

Reference

Definice

Obor názvů:: System.Net

Sestavení:: System.Net.HttpListener.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Zdroj:: HttpListenerResponse.cs

Zdroj:: HttpListenerResponse.cs

Zdroj:: HttpListenerResponse.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá zadanou hlavičku a hodnotu do hlaviček PROTOKOLU 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 hlavičky name .

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 .NET Framework a .NET Core verze 2.0–3.1: Délka value souboru 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ží novou hlavičku Headers do 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 .

Platí pro