WebUtility::UrlEncodeToBytes Method (array<Byte>^, Int32, Int32)

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

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

static array<unsigned char>^ UrlEncodeToBytes(
	array<unsigned char>^ value,
	int offset,
	int count


Type: array<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: array<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.

Universal Windows Platform
Available since 8
.NET Framework
Available since 4.5
Portable Class Library
Supported in: portable .NET platforms
Windows Phone Silverlight
Available since 8.0
Windows Phone
Available since 8.1
Return to top