HttpEncoder.UrlEncode Method (Byte[], Int32, Int32)
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)
Parameters
- bytes
-
Type:
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 null. |
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 |
Available since 4.0