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

Definition

Namespace:
System.Web.Util
Assemblys:
System.Web.dll, System.Web.Services.dll

Codiert ein Array von Zeichen, die in einer URL nicht zulässig sind, in eine Hexadezimalzeichenentitä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 Bytes, die codiert werden sollen.

offset
Int32

Die Position im Array, an der bytes die Codierung beginnen soll.

count
Int32

Die Anzahl der zu codierenden Elemente im bytes Array.

Gibt zurück

Byte[]

Ein Array codierter Zeichen.

Ausnahmen

ArgumentOutOfRangeException

offset ist kleiner als Null oder größer als die Länge des bytes Arrays.

-oder-

count ist kleiner als 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-Codierungsmethoden in der HttpUtility Klasse aufgerufen.

Die UrlEncode Methode URL-codiert alle Zeichen, die sich nicht in der Gruppe von ASCII-Zeichen befinden, die als URL-sicher betrachtet werden. Leerzeichen werden als ASCII-Zeichen+" codiert. URL-sichere ASCII-Zeichen umfassen die ASCII-Zeichen (A bis Z und a bis z), Ziffern (0 bis 9) und einige Satzzeichen. In der folgenden Tabelle sind die Interpunktionszeichen aufgeführt, die als URL-sichere ASCII-Zeichen gelten.

Character Description
- Bindestrich
_ Unterstrich
. Punkt (Punkt)
! Ausrufezeichen
* Sternchen (Stern)
( Öffnende Klammer
) Schließende Klammer

Gilt für: