WebUtility.UrlEncode(String) 方法

定義

命名空間:

System.Net

組件:

netstandard.dll, System.Runtime.dll

來源:

WebUtility.cs

將文字字串轉換為 URL 編碼字串。

public:
 static System::String ^ UrlEncode(System::String ^ value);

public static string? UrlEncode(string? value);

static member UrlEncode : string -> string

Public Shared Function UrlEncode (value As String) As String

參數

value

String

文字轉為 URL 編碼。

傳回

String

一個 URL 編碼的字串。

備註

如果在 HTTP 串流中傳遞空白和標點符號等字元，接收端可能會被誤解。 URL 編碼以字元-實體等價的十六進位跳脫序列取代不允許的字元。 轉換後的字串預期符合 UTF-8 格式。

URL 編碼取代除了字母、數字及以下標點符號外的所有字元代碼：

• - （減號）

• _ (底線)

• . (期間)

• ! （驚嘆號）

• * (星號)

• ( 以及 ) （開閉括號）

每個 ' '（空格）字元會轉換成一個 + （加號）字元。

Note

僅在 URI 的查詢部分（慣例而非標準） application/x-www-form-urlencoded 或 HTTP 內容中，才會將 ' '（空格）替換為 '+'（加號）。 此外，上述 未 被替換的字元清單既不符合 URL 規範 ，也不符合 URI RFC 3986。 用於 EscapeDataString 符合 RFC 規範的轉換。

例如，當嵌入到要傳送的 URL 文字區塊中時，字元 < 和 > 會編碼為 %3c 和 %3e。

此 UrlDecode 方法反向編碼。