Export (0) Print
Expand All

HttpEncoder.UrlEncode Method

.NET Framework 4.6 and 4.5

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)

abstract UrlEncode : 
        bytes:byte[] * 
        offset:int * 
        count:int -> byte[] 
override UrlEncode : 
        bytes:byte[] * 
        offset:int * 
        count:int -> 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.

Return Value

Type: System.Byte[]
An array of encoded characters.

ExceptionCondition
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 a null reference (Nothing in Visual Basic).

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

.NET Framework

Supported in: 4.6, 4.5, 4
Show:
© 2015 Microsoft