Sdílet prostřednictvím

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

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 .

Platí pro

Viz také