HttpEncoder.UrlEncode(Byte[], Int32, Int32) Méthode

Définition

Espace de noms:

System.Web.Util

Assemblys:

System.Web.dll, System.Web.Services.dll

Encode un tableau des caractères non autorisés dans une URL sous la forme d'une entité de caractère hexadécimal équivalente.

protected public:
 virtual cli::array <System::Byte> ^ UrlEncode(cli::array <System::Byte> ^ bytes, int offset, int count);

protected internal virtual byte[] UrlEncode (byte[] bytes, int offset, int count);

abstract member UrlEncode : byte[] * int * int -> byte[]
override this.UrlEncode : byte[] * int * int -> byte[]

Protected Friend Overridable Function UrlEncode (bytes As Byte(), offset As Integer, count As Integer) As Byte()

Paramètres

bytes

Byte[]

Tableau d'octets à encoder.

offset

Int32

Position dans le tableau bytes au niveau de laquelle commencer l'encodage.

count

Int32

Nombre d'éléments dans le tableau bytes à encoder.

Retours

Byte[]

Tableau de caractères encodés.

Exceptions

ArgumentOutOfRangeException

offset est inférieur à zéro ou supérieur à la longueur du tableau bytes.

- ou -

count est inférieur à zéro ou count plus offset est supérieur à la longueur du tableau bytes.

ArgumentNullException

bytes a la valeur null.

Remarques

La UrlEncode méthode est appelée par plusieurs méthodes d’encodage d’URL dans la HttpUtility classe .

La UrlEncode méthode ENCODE URL n’importe quel caractère qui ne figure pas dans l’ensemble de caractères ASCII considérés comme sécurisés par URL. Les espaces sont encodés en tant que caractère ASCII .+" Les caractères ASCII sécurisés par URL incluent les caractères ASCII (A à Z et a à z), les chiffres (0 à 9) et certains signes de ponctuation. Le tableau suivant répertorie les signes de ponctuation considérés comme des caractères ASCII sécurisés par URL.

Caractère	Description
-	Hyphen
_	Trait de soulignement
.	Point (point)
!	Point d'exclamation
*	Astérisque (étoile)
(	Parenthèse ouvrante
)	Parenthèse fermante