WebUtility.UrlEncode(String) Método

Definição

Namespace:

System.Net

Assembly:

System.Runtime.dll

Origem:

WebUtility.cs

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 a ser codificado em 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 interpretados incorretamente na extremidade de 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 subtração)

• _ (sublinhado)

• . (ponto final)

• ! (ponto de exclamação)

• * (asterisco)

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

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

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.