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) 构造函数 将字符串解析为组件（例如主机和路径之间的“/”或路径和查询之间的“？”）的字符进行转义。

如果 HTTP 请求方案需要统一资源标识符 (URI) 转义字符串，例如在 Windows.Web.Http 命名空间中使用 API，则 EscapeComponent 可能也很有用。

另请参阅

• Uri(String)