Uri.EscapeUriString(String) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

組件:

System.dll

組件:

netstandard.dll

警告

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

警告

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);

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.", 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}")]
public static string EscapeUriString (string stringToEscape);

static member EscapeUriString : string -> string

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

[<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

stringToEscape 的長度超過 32766 個字元。

注意：在適用于 Windows Microsoft Store 應用程式或可攜式類別庫的 .NET 中，改為攔截基類例外狀況 FormatException 。

備註

EscapeUriString使用 方法來準備未逸出的 URI 字串，以做為建構函式的參數 Uri 。

根據預設， EscapeUriString 方法會將 RFC 2396 未保留字元以外的所有字元轉換為其十六進位標記法。 如果已啟用國際資源識別碼 (IRI) 或國際化功能變數名稱 () 剖析， EscapeUriString 則方法會將 RFC 3986 未保留字元以外的所有字元轉換為其十六進位標記法。 所有 Unicode 字元都會在逸出之前轉換為 UTF-8 格式。

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

根據預設，字串會根據 RFC 2396 逸出。 如果啟用國際資源識別碼 (IRI) 或國際化功能變數名稱 (IDN) 剖析，則會根據 RFC 3986 和 RFC 3987 逸出字串。 如需保留和未保留字元的定義，請參閱這些 RFC。

如需 IRI 支援的詳細資訊，請參閱 類別的 Uri 一節。