Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
UrlEncodeToBytes Method

WebUtility.UrlEncodeToBytes Method

.NET Framework 4.6 and 4.5

Converts a byte array into a URL-encoded byte array.

Namespace:  System.Net
Assemblies:   System.Runtime.Extensions (in System.Runtime.Extensions.dll)
  System (in System.dll)

public static byte[] UrlEncodeToBytes(
	byte[] value,
	int offset,
	int count


Type: System.Byte[]

The Byte array to URL-encode.

Type: System.Int32

The offset, in bytes, from the start of the Byte array to encode.

Type: System.Int32

The count, in bytes, to encode from the Byte array.

Return Value

Type: System.Byte[]
Returns Byte.
An encoded Byte array.

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 UrlDecodeToBytes method reverses the encoding.

.NET Framework

Supported in: 4.6, 4.5

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8
© 2015 Microsoft