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 de caractères qui ne sont pas autorisés dans une URL en équivalent hexadécimal d’entité de caractères.

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 à laquelle commencer l’encodage bytes .

count
Int32

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

Retours

Byte[]

Tableau de caractères encodés.

Exceptions

ArgumentOutOfRangeException

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

- ou -

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

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.

L’URL UrlEncode de la méthode encode tout caractère qui n’est pas dans l’ensemble de caractères ASCII considérés comme sécurisés par l’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 quelques marques de ponctuation. Le tableau suivant répertorie les marques de ponctuation considérées comme des caractères ASCII sécurisés par URL.

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

S’applique à