共用方式為


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

定義

將標頭名稱及值編碼為可當做 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 headerValue encodedHeaderValue 如果 headerValuenull 或為空字串,則方法的預設實值會傳回中的值。 同樣地, headerName encodedHeaderName 如果 headerNamenull 或為空字串,則預設的執行會傳回的值。

適用於