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

定义

命名空间:
System.Web.Util
程序集:
System.Web.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 输入字符串并对其进行编码。 编码的值作为 out 参数返回。

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

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

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

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

  • 所有其他字符均未编码。

    注释

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

该方法的默认实现HeaderNameValueEncode返回 in headerValue 值encodedHeaderValue（如果headerValue为null或为空字符串）。 同样，默认实现返回 in 值headerNameencodedHeaderName（如果headerName为null或为空字符串）。

适用于