HttpEncoder::UrlEncode Method
Encodes an array of characters that are not allowed in a URL into a hexadecimal character-entity equivalent.
Assembly: System.Web (in System.Web.dll)
protected public: virtual array<unsigned char>^ UrlEncode( array<unsigned char>^ bytes, int offset, int count )
Parameters
- bytes
- Type: array<System::Byte>
An array of bytes to encode.
- offset
- Type: System::Int32
The position in the bytes array at which to begin encoding.
- count
- Type: System::Int32
The number of items in the bytes array to encode.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | offset is less than zero or greater than the length of the bytes array. -or- count is less than zero or count plus offset is greater than the length of the bytes array. |
| ArgumentNullException | bytes is nullptr. |
The UrlEncode method is called by several URL encoding methods in the HttpUtility class.
The UrlEncode method URL-encodes any character that is not in the set of ASCII characters that is considered to be URL-safe. Spaces are encoded as the ASCII "+" character. URL-safe ASCII characters include the ASCI characters (A to Z and a to z), numerals (0 to 9), and some punctuation marks. The following table lists the punctuation marks that are considered URL-safe ASCII characters.
Character | Description |
|---|---|
- | Hyphen |
_ | Underscore |
. | Period (dot) |
! | Exclamation mark |
* | Asterisk (star) |
( | Opening parenthesis |
) | Closing parenthesis |
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.