HttpListenerResponse.AddHeader(String, String) Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.HttpListener.dll

Sumber:

HttpListenerResponse.cs

Menambahkan header dan nilai yang ditentukan ke header HTTP untuk respons ini.

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)

Parameter

name

String

Nama header HTTP yang akan diatur.

value

String

Nilai untuk name header .

Pengecualian

ArgumentNullException

name adalah null atau string kosong ("").

ArgumentException

Anda tidak diperbolehkan menentukan nilai untuk header yang ditentukan.

-atau-

name atau value berisi karakter yang tidak valid.

ArgumentOutOfRangeException

.NET Framework dan .NET Core versi 2.0 - 3.1 saja: Panjangnya value lebih besar dari 65.535 karakter.

Contoh

Contoh kode berikut menunjukkan penambahan header menggunakan properti ini.

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

Keterangan

Memanggil metode ini setara dengan memanggil Set metode pada koleksi yang dikembalikan oleh Headers properti .

Jika header yang ditentukan di name tidak ada, metode ini menyisipkan header baru ke Headers dalam koleksi properti. Jika name ada dalam koleksi, metode ini menggantikan nilai yang ada dengan value. Untuk menambahkan nilai ke header yang ada tanpa mengganti nilai yang ada, gunakan AppendHeader metode .

Lihat juga

• HttpListener
• HttpListenerContext
• HttpListenerRequest
• WebHeaderCollection