WebUtility.UrlEncode(String) Método

Definição

Espaço de Nomes:
System.Net
Assemblagens:
System.dll, System.Runtime.Extensions.dll
Assemblagem:
System.dll
Assemblagem:
System.Runtime.Extensions.dll
Assemblagem:
netstandard.dll

Converte uma cadeia de texto numa cadeia codificada por 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

Parâmetros

value
String

A codificação de texto para URL.

Devoluções

String

Uma cadeia codificada por URL.

Observações

Se caracteres como espaços em branco e pontuação forem passados num fluxo HTTP, podem ser mal interpretados na parte receptora. A codificação de URL substitui caracteres que não são permitidos numa URL por equivalentes entidade de carácter consistindo em sequências de escape hexadecimais. Espera-se que a cadeia convertida cumpra o formato UTF-8.

A codificação URL substitui todos os códigos de caracteres, exceto letras, números e os seguintes caracteres de pontuação:

  • - (sinal de menos)

  • _ (sublinhado)

  • . (ponto final)

  • ! (ponto de exclamação)

  • * (asterisco)

  • ( e ) (parênteses de abertura e fecho)

Cada carácter ' ' (espaço) é convertido num + carácter (mais).

Note

Substituir ' ' (espaço) por um sinal '+' (mais) é esperado apenas na parte de consulta do URI (por convenção, não por padrão) ou no application/x-www-form-urlencoded conteúdo HTTP. Além disso, a lista acima mencionada de caracteres que não são substituídos não corresponde nem à especificação de URL nem ao URI RFC 3986. Use EscapeDataString para transformação compatível com RFC.

Por exemplo, quando incorporados num bloco de texto a ser transmitido numa URL, os caracteres < e > são codificados como %3c e %3e.

O UrlDecode método inverte a codificação.

Aplica-se a