HttpListenerResponse.AddHeader(String, String) 方法

定義

命名空間:

System.Net

組件:

System.Net.HttpListener.dll

來源:

HttpListenerResponse.cs

將指定的標頭和值加入至這個回應的 HTTP 標頭。

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)

參數

name

String

要設定的 HTTP 標頭名稱。

value

String

name 標頭的值。

例外狀況

ArgumentNullException

name 為 null 或空字串 ("")。

ArgumentException

您不可指定該特定標頭的值。

-或-

name 或 value 包含無效字元。

ArgumentOutOfRangeException

僅限 .NET Framework 與 .NET Core 2.0 - 3.1 版：value 的長度大於 65,535 個字元。

範例

下列程式代碼範例示範如何使用這個屬性新增標頭。

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

備註

呼叫這個方法相當於在 屬性所Headers傳回的集合上呼叫 Set 方法。

如果 中指定的 name 標頭不存在，這個方法會將新的標頭 Headers 插入屬性的集合中。 如果 name 存在於集合中，這個方法會將現有的值取代為 value。 若要將值新增至現有的標頭，而不取代現有的值，請使用 AppendHeader 方法。

另請參閱

• HttpListener
• HttpListenerContext
• HttpListenerRequest
• WebHeaderCollection