Uri.EscapeComponent(String) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将统一资源标识符 (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
要转换的字符串。
返回
toEscape 的转义表示形式。
注解
使用 EscapeComponent 作为实用工具，可以转义任何统一资源标识符 (URI) 组件，这些组件需要转义以构造有效的 Uri 对象。 例如，如果应用使用用户提供的字符串并将其添加到发送到服务的查询中，则可能需要在统一资源标识符 (URI) 中转义该字符串，因为该字符串可能包含在统一资源标识符 (URI) 无效的字符。 这包括简单如空格的字符;即使是看似纯 ASCII 的输入，也可能需要编码作为统一资源标识符 (URI) 组件有效。
在调用 Uri (String) 构造函数之前，可以将从 EscapeComponent 获取的字符串追加到其他字符串上。 需要单独对每个组件进行编码，因为不希望对 Uri (String) 构造函数 将字符串解析为组件（例如主机和路径之间的“/”或路径和查询之间的“？”）的字符进行转义。
如果 HTTP 请求方案需要统一资源标识符 (URI) 转义字符串，例如在 Windows.Web.Http 命名空间中使用 API，则 EscapeComponent 可能也很有用。