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 並進行編碼。 編碼的值會以 out 參數傳回。

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 或為空字串，則預設的執行會傳回的值。