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


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

Converts an array of bytes into a URL-encoded array of bytes, starting at the specified position in the array and continuing for the specified number of bytes.

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

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


Type: array<System::Byte>^

The array of bytes to encode.

Type: System::Int32

The position in the byte array at which to begin encoding.

Type: System::Int32

The number of bytes to encode.

Return Value

Type: array<System::Byte>^

An encoded array of bytes.

Exception Condition

bytes is null, but count does not equal 0.


offset is less than 0 or greater than the length of the bytes array.

- or -

count is less than 0, or count + offset is greater than the length of the bytes array.

If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters < and > are encoded as %3c and %3e.

To encode or decode values outside of a web application, use the WebUtility class.

.NET Framework
Available since 1.1
Return to top