Compartilhar via


Uri.EscapeComponent(String) Método

Definição

Converte uma cadeia de caracteres de URI (Uniform Resource Identifier) em sua representação de escape.

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

Parâmetros

toEscape
String

Platform::String

winrt::hstring

A cadeia de caracteres a ser convertida.

Retornos

String

Platform::String

winrt::hstring

A representação de escape do toEscape.

Comentários

Use EscapeComponent como um utilitário para escapar de qualquer componente de URI (Uniform Resource Identifier) que exija escape para construir um objeto URI válido. Por exemplo, se o aplicativo estiver usando uma cadeia de caracteres fornecida pelo usuário e adicionando-a a uma consulta enviada a um serviço, talvez seja necessário escapar dessa cadeia de caracteres no URI (Uniform Resource Identifier), pois a cadeia de caracteres pode conter caracteres inválidos em um URI (Uniform Resource Identifier). Isso inclui caracteres tão simples quanto espaços; até mesmo a entrada que parece ser pura ASCII ainda pode precisar que a codificação seja válida como um componente de um URI (Uniform Resource Identifier).

Você pode acrescentar a cadeia de caracteres que obtém de EscapeComponent a outras cadeias de caracteres antes de chamar o construtor Uri(String). Você desejará codificar cada componente separadamente, pois não deseja escapar os caracteres que são significativos para como o construtor Uri(String) analisa a cadeia de caracteres em componentes, como o "/" entre o host e o caminho ou o "?" entre o caminho e a consulta.

EscapeComponent também pode ser útil para outros cenários em que uma cadeia de caracteres com escape de URI (Uniform Resource Identifier) é necessária para um cenário de solicitação HTTP, como o uso de APIs no namespace Windows.Web.Http .

Aplica-se a

Confira também