HttpListenerResponse.AddHeader(String, String) Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.HttpListener.dll

Kaynak:

HttpListenerResponse.cs

Belirtilen üst bilgiyi ve değeri bu yanıt için HTTP üst bilgilerine ekler.

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)

Parametreler

name

String

Ayarlanacağı HTTP üst bilgisinin adı.

value

String

Üst bilgi için name değer.

Özel durumlar

ArgumentNullException

name veya null boş bir dize ("").

ArgumentException

Belirtilen üst bilgi için bir değer belirtmenize izin verilmiyor.

-veya-

name veya value geçersiz karakterler içeriyor.

ArgumentOutOfRangeException

Yalnızca .NET Framework ve .NET Core sürümleri 2.0 - 3.1: Uzunluğu value 65.535 karakterden fazladır.

Örnekler

Aşağıdaki kod örneği, bu özelliği kullanarak üst bilgi eklemeyi gösterir.

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

Açıklamalar

Bu yöntemi çağırmak, özelliği tarafından döndürülen koleksiyonda yöntemini çağırmaya SetHeaders eşdeğerdir.

içinde name belirtilen üst bilgi yoksa, bu yöntem özelliğin koleksiyonuna Headers yeni bir üst bilgi ekler. koleksiyonda varsa name , bu yöntem mevcut değeri ile valuedeğiştirir. Var olan değeri değiştirmeden var olan bir üst bilgisine değer eklemek için yöntemini kullanın AppendHeader .

Ayrıca bkz.

• HttpListener
• HttpListenerContext
• HttpListenerRequest
• WebHeaderCollection