HttpEncoder.HeaderNameValueEncode(String, String, String, String) 方法

定义

命名空间:

System.Web.Util

程序集:

System.Web.dll, System.Web.Services.dll

程序集:

System.Web.Services.dll

将标头名称和值编码为可用作 HTTP 标头的字符串。

protected public:
 virtual void HeaderNameValueEncode(System::String ^ headerName, System::String ^ headerValue, [Runtime::InteropServices::Out] System::String ^ % encodedHeaderName, [Runtime::InteropServices::Out] System::String ^ % encodedHeaderValue);

protected internal virtual void HeaderNameValueEncode (string headerName, string headerValue, out string encodedHeaderName, out string encodedHeaderValue);

abstract member HeaderNameValueEncode : string * string * string * string -> unit
override this.HeaderNameValueEncode : string * string * string * string -> unit

Protected Friend Overridable Sub HeaderNameValueEncode (headerName As String, headerValue As String, ByRef encodedHeaderName As String, ByRef encodedHeaderValue As String)

参数

headerName

String

要编码的 HTTP 标头名称。

headerValue

String

要编码的 HTTP 标头值。

encodedHeaderName

String

当此方法返回时，返回值包含要用于 HTTP 标头的已编码名称。 此参数未经初始化即被传递。

encodedHeaderValue

String

当此方法返回时，返回值包含要用于 HTTP 标头的已编码值。 此参数未经初始化即被传递。

注解

HeaderNameValueEncode方法从和参数获取输入字符串 headerName headerValue 并对它们进行编码。 编码值作为输出参数返回。

HeaderNameValueEncode方法使用以下逻辑对标头名称和值进行编码：

• Unicode 值小于 ASCII 字符32的所有字符（ASCII 字符9除外）都将 URL 编码为 %NN N 字符表示十六进制值的格式。

• ASCII 字符 9 (水平制表符) 不是 URL 编码的字符。

• ASCII 字符127编码为 %7F 。

• 所有其他字符不进行编码。

  备注

  尽管此方法可用于 Unicode 值，但它通常用于 ASCII 范围内的值。

HeaderNameValueEncode headerValue encodedHeaderValue 如果 headerValue 为 null 或为空字符串，则方法的默认实现将返回中的值。 同样， headerName encodedHeaderName 如果 headerName 为 null 或为空字符串，则默认实现将返回中的值。