Uri.EscapeComponent(String) 方法

定義

命名空間:

Windows.Foundation

將統一資源識別項 (URI) 字串轉換成其逸出表示。

public:
 static Platform::String ^ EscapeComponent(Platform::String ^ toEscape);

 static winrt::hstring EscapeComponent(winrt::hstring const& toEscape);

public static string EscapeComponent(string toEscape);

function escapeComponent(toEscape)

Public Shared Function EscapeComponent (toEscape As String) As String

參數

toEscape

String

Platform::String

winrt::hstring

要轉換的字串。

傳回

String

Platform::String

winrt::hstring

toEscape的逸出標記法。

備註

使用 EscapeComponent 作為公用程式，以逸出任何需要逸出才能建構有效 Uri 物件的統一資源識別元 (URI) 元件。 例如，如果您的應用程式使用使用者提供的字串，並將它新增至傳送至服務的查詢，您可能需要在統一資源識別項 (URI 中逸出該字串) ，因為字串可能包含在統一資源識別項 (URI) 中不正確字元。 這包括與空格一樣簡單的字元;即使是看似純 ASCII 的輸入，仍需要編碼為統一資源識別項的元件， (URI) 。

您可以在呼叫 Uri (String) 建構函式之前，先將從 EscapeComponent 取得的字串附加至其他字串。 您會想要個別編碼每個元件，因為您不想逸出 Uri (String) 建構 函式將字串剖析成元件的重要字元，例如主機和路徑之間的 「/」 或路徑與查詢之間的 「？」。

EscapeComponent 可能也適用于 HTTP 要求案例需要統一資源識別元 (URI) 逸出字串的其他案例，例如在 Windows.Web.Http 命名空間中使用 API。

另請參閱

• Uri(String)