HttpEncoder.UrlEncode(Byte[], Int32, Int32) Methode

Definition

Namespace:

System.Web.Util

Assemblys:

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

Assembly:

System.Web.Services.dll

Codiert ein Array von Zeichen, die in einer URL nicht zulässig sind, in eine hexadezimale Zeichenentitätsentsprechung.

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()

Parameter

bytes

Byte[]

Ein Array von zu codierenden Bytes.

offset

Int32

Die Position im bytes-Array, an der mit der Codierung begonnen werden soll.

count

Int32

Die zu codierende Anzahl der Elemente im bytes.

Gibt zurück

Byte[]

Ein Array von codierten Zeichen.

Ausnahmen

ArgumentOutOfRangeException

offset ist kleiner als 0 (null) oder größer als die Länge des bytes-Arrays.

- oder - count ist kleiner als 0 (null) oder count plus offset ist größer als die Länge des bytes-Arrays.

ArgumentNullException

bytes ist null.

Hinweise

Die- UrlEncode Methode wird von mehreren URL-Codierungs Methoden in der- HttpUtility Klasse aufgerufen.

Die UrlEncode Methode URL codiert alle Zeichen, die nicht in der Gruppe von ASCII-Zeichen enthalten sind, die als URL-sicher angesehen werden. Leerzeichen werden als ASCII-Zeichen codiert +" . URL-sichere ASCII-Zeichen enthalten die ASCII-Zeichen (a bis z und a bis z), Ziffern (0 bis 9) und einige Interpunktions Zeichen. In der folgenden Tabelle werden die Interpunktions Zeichen aufgelistet, die als URL-sichere ASCII-Zeichen angesehen werden.

Zeichen	Beschreibung
-	Hyphen
_	Unterstrich
.	Zeitraum (Punkt)
!	Ausrufezeichen
*	Sternchen (Stern)
(	Öffnende Klammer
)	Schließende Klammer