Uri.EscapeUriString(String) 方法

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

UriExt.cs

警告

Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.

將 URI 字串轉換為其轉義表示。

public:
 static System::String ^ EscapeUriString(System::String ^ stringToEscape);

[System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static string EscapeUriString(string stringToEscape);

[<System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member EscapeUriString : string -> string

Public Shared Function EscapeUriString (stringToEscape As String) As String

參數

stringToEscape

String

要逸出的字串。

傳回

String

逃逸的表示 stringToEscape。

屬性

ObsoleteAttribute

例外狀況

ArgumentNullException

stringToEscape 是 null。

UriFormatException

僅.NET框架：stringToEscape 長度超過 32766 個字元。

備註

使用 EscapeUriString 該方法將未跳脫的 URI 字串作為建構子的參數 Uri 。

預設情況下，該 EscapeUriString 方法會將除 RFC 2396 未保留字元外的所有字元轉換為其十六進位表示。 若啟用國際資源識別碼（IRI）或國際化網域名稱（IDN）解析，該 EscapeUriString 方法會將除 RFC 3986 未保留字元外的所有字元轉換為其十六進位表示。 所有 Unicode 字元在轉義前都會被轉換成 UTF-8 格式。

此方法假設 中 stringToEscape 沒有逃逸序列。

預設情況下，字串會依據 RFC 2396 進行轉義。 若啟用國際資源識別碼（IRI）或國際化網域名稱（IDN）解析，則依據 RFC 3986 與 RFC 3987，字串會被轉義。 請參閱這些 RFC 以了解保留字元與非保留字元的定義。

欲了解更多關於IRI支援的資訊，請參閱該 Uri 課程備註區。