Uri.EscapeComponent(String) Méthode

Définition

Espace de noms:

Windows.Foundation

Convertit une chaîne URI (Uniform Resource Identifier) en sa représentation d’échappement.

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

Paramètres

toEscape

String

Platform::String

winrt::hstring

Chaîne à convertir.

Retours

String

Platform::String

winrt::hstring

Représentation d’échappement de toEscape.

Remarques

Utilisez EscapeComponent en tant qu’utilitaire pour échapper à tout composant URI (Uniform Resource Identifier) qui nécessite l’échappement afin de construire un objet URI valide. Par exemple, si votre application utilise une chaîne fournie par l’utilisateur et l’ajoute à une requête envoyée à un service, vous devrez peut-être placer cette chaîne dans l’URI (Uniform Resource Identifier), car la chaîne peut contenir des caractères non valides dans un URI (Uniform Resource Identifier). Cela inclut des caractères aussi simples que des espaces ; même une entrée qui semble être un ASCII pur peut encore avoir besoin d’un encodage pour être valide en tant que composant d’un URI (Uniform Resource Identifier).

Vous pouvez ajouter la chaîne que vous obtenez à partir d’EscapeComponent à d’autres chaînes avant d’appeler le constructeur Uri(String). Vous souhaiterez encoder chaque composant séparément, car vous ne souhaitez pas créer d’échappement les caractères significatifs de la façon dont le constructeur Uri(String) analyse la chaîne en composants, tels que le « / » entre l’hôte et le chemin d’accès ou « ? » entre le chemin d’accès et la requête.

EscapeComponent peut également être utile pour d’autres scénarios où une chaîne d’échappement URI (Uniform Resource Identifier) est nécessaire pour un scénario de requête HTTP, comme l’utilisation d’API dans l’espace de noms Windows.Web.Http .

Voir aussi

• Uri(String)