WebUtility.UrlEncode(String) Méthode

Définition

Espace de noms:
System.Net
Assemblys:
System.dll, System.Runtime.Extensions.dll
Assembly:
System.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll

Convertit une chaîne de texte en chaîne encodée url.

public:
 static System::String ^ UrlEncode(System::String ^ value);
public static string UrlEncode(string value);
static member UrlEncode : string -> string
Public Shared Function UrlEncode (value As String) As String

Paramètres

value
String

Texte encodé par URL.

Retours

String

Chaîne encodée d’URL.

Remarques

Si des caractères tels que des espaces et des ponctuations sont transmis dans un flux HTTP, ils peuvent être mal interprétés à la fin de la réception. L’encodage d’URL remplace les caractères qui ne sont pas autorisés dans une URL par des équivalents d’entité de caractères constitués de séquences d’échappement hexadécimales. La chaîne convertie est censée être conforme au format UTF-8.

L’encodage d’URL remplace tous les codes de caractères à l’exception des lettres, des chiffres et des caractères de ponctuation suivants :

  • - (signe moins)

  • _ (trait de soulignement)

  • . (point)

  • ! (point d’exclamation)

  • * (astérisque)

  • ( et ) (parenthèses ouvrantes et fermante)

Chaque caractère ' (espace) est converti en caractère + (plus).

Note

Le remplacement de ' ' (espace) par un signe '+' (plus) est attendu uniquement dans la partie de requête de l’URI (par convention, pas par norme) ou dans le application/x-www-form-urlencoded contenu HTTP. De plus, la liste mentionnée ci-dessus des caractères qui ne sont pas remplacés ne correspond pas à la spécification d’URL ni à la spécification d’URI RFC 3986. Utiliser EscapeDataString pour la transformation conforme RFC.

Par exemple, lorsqu’il est incorporé dans un bloc de texte à transmettre dans une URL, les caractères < et > sont encodés en tant que %3c et %3e.

La UrlDecode méthode inverse l’encodage.

S’applique à