語言

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方法從 AND headerName 參數中擷取輸入字串headerValue並進行編碼。 編碼後的值會以輸出參數的形式回傳。

此 HeaderNameValueEncode 方法使用以下邏輯來編碼標頭名稱與值：

  • 所有 Unicode 值小於 ASCII 字元 32 的字元（除了 ASCII 字元 9 外），皆以 URL 編碼為字元代表十六進位值的格式%NNN。

  • ASCII 字元 9（水平制表字元）並非 URL 編碼。

  • ASCII 字元 127 編碼為 %7F。

  • 其他字元則未被編碼。

    Note

    雖然此方法可用於 Unicode 值，但通常用於 ASCII 範圍的值。

該方法的HeaderNameValueEncode預設實作會回傳 的headerValueencodedHeaderValue值，若 headerValue 是null空字串。 同理，預設headerName實作會回傳 若 是encodedHeaderName空字串，則回傳 的headerNamenull值。

適用於