HttpListenerResponse.AddHeader(String, String) 方法

定义

命名空间:

System.Net

程序集:

System.Net.HttpListener.dll

Source:

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 的长度大于 65535 个字符。

示例

下面的代码示例演示如何使用此属性添加标头。

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

注解

调用此方法等效于对 属性返回的集合调用 Set 方法 Headers 。

如果 中指定的 name 标头不存在，此方法会将新标头插入 Headers 属性的集合中。 如果 name 集合中存在 ，则此方法将现有值 value替换为 。 若要向现有标头添加值而不替换现有值，请使用 AppendHeader 方法。

另请参阅

• HttpListener
• HttpListenerContext
• HttpListenerRequest
• WebHeaderCollection