HttpEncoder.UrlEncode Method
Encodes an array of characters that are not allowed in a URL into a hexadecimal character-entity equivalent.
Namespace: System.Web.Util
Assembly: System.Web (in System.Web.dll)
'Declaration Protected Friend Overridable Function UrlEncode ( _ bytes As Byte(), _ offset As Integer, _ count As Integer _ ) As Byte()
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 Nothing. |
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 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
