WebUtility.UrlEncode(String) Método

Definição

Namespace:
System.Net
Assemblies:
System.dll, System.Runtime.Extensions.dll
Assembly:
System.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll

Converte uma cadeia de caracteres de texto em uma cadeia de caracteres codificada em 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

O texto para codificação de URL.

Retornos

String

Uma cadeia de caracteres codificada em URL.

Comentários

Se caracteres como espaços em branco e pontuação forem passados em um fluxo HTTP, eles poderão ser mal interpretados no final do recebimento. A codificação de URL substitui caracteres que não são permitidos em uma URL por equivalentes de entidade de caractere que consistem em sequências de escape hexadecimal. Espera-se que a cadeia de caracteres convertida esteja em conformidade com o formato UTF-8.

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

  • - (sinal de menos)

  • _ (sublinhado)

  • . (ponto final)

  • ! (ponto de exclamação)

  • * (asterisco)

  • ( e ) (abrir e fechar parênteses)

Cada caractere ' ' (espaço) é convertido em um + caractere (mais).

Note

A substituição de ' ' (espaço) por um sinal '+' (mais) é esperada 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 mencionada acima 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 a transformação em conformidade com RFC.

Por exemplo, quando inserido em um bloco de texto a ser transmitido em uma URL, os caracteres < e > são codificados como %3c e %3e.

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

Aplica-se a