Поделиться через


Uri.EscapeComponent(String) Метод

Определение

Преобразует строку универсального кода ресурса (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).

Строку, полученную из EscapeComponent, можно добавить в другие строки перед вызовом конструктора Uri(String). Вам потребуется закодировать каждый компонент отдельно, так как не требуется экранировать символы, которые важны для того, как конструктор Uri(String) анализирует строку на компоненты, такие как "/" между узлом и путем или "?" между путем и запросом.

EscapeComponent также может быть полезен в других сценариях, где для сценария HTTP-запроса требуется строка с универсальным идентификатором ресурса (URI), например с использованием API в пространстве имен Windows.Web.Http .

Применяется к

См. также раздел