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

 
System_CAPS_noteNote

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 URL-encoded byte array into a decoded string using the specified encoding object, 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)

public:
static String^ UrlDecode(
	array<unsigned char>^ bytes,
	int offset,
	int count,
	Encoding^ e
)

Parameters

bytes
Type: array<System::Byte>^

The array of bytes to decode.

offset
Type: System::Int32

The position in the byte to begin decoding.

count
Type: System::Int32

The number of bytes to decode.

e
Type: System.Text::Encoding^

The Encoding object that specifies the decoding scheme.

Return Value

Type: System::String^

A decoded string.

Exception Condition
ArgumentNullException

bytes is null, but count does not equal 0.

ArgumentOutOfRangeException

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
Show: