Export (0) Print
Expand All

WebUtility.UrlEncode Method

.NET Framework 4.5

Converts a text string into a URL-encoded string.

Namespace:  System.Net
Assembly:  System (in System.dll)

public static string UrlEncode(
	string value
)

Parameters

value
Type: System.String

The text to URL-encode.

Return Value

Type: System.String
Returns String.
A URL-encoded string.

If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding replaces characters that are not allowed in a URL with character-entity equivalents consisting of hexadecimal escape sequences. The converted string is expected to conform to the UTF-8 format.

URL encoding replaces all character codes except for letters, numbers, and the following punctuation characters:

  • - (minus sign)

  • _ (underscore)

  • . (period)

  • ! (exclamation point)

  • * (asterisk)

  • ' (single quotation mark)

  • ( and ) (opening and closing parentheses)

For example, when embedded in a block of text to be transmitted in a URL, the characters < and > are encoded as %3c and %3e.

The UrlDecode method reverses the encoding.

.NET Framework

Supported in: 4.6, 4.5

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft