WebUtility.UrlEncodeToBytes(Byte[], Int32, Int32) Methode

Definition

Namespace:
System.Net
Assemblys:
System.dll, System.Runtime.Extensions.dll
Assembly:
System.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll

Konvertiert ein Bytearray in ein URL-codiertes Bytearray.

public:
 static cli::array <System::Byte> ^ UrlEncodeToBytes(cli::array <System::Byte> ^ value, int offset, int count);
public static byte[] UrlEncodeToBytes(byte[] value, int offset, int count);
static member UrlEncodeToBytes : byte[] * int * int -> byte[]
Public Shared Function UrlEncodeToBytes (value As Byte(), offset As Integer, count As Integer) As Byte()

Parameter

value
Byte[]

Das Byte Array zur URL-Codierung.

offset
Int32

Der Offset (in Byte) vom Anfang des Byte Arrays zum Codieren.

count
Int32

Die Anzahl in Bytes, die aus dem Byte Array codiert werden soll.

Gibt zurück

Byte[]

Ein codiertes Byte Array.

Hinweise

Wenn Zeichen wie Leerzeichen und Interpunktionszeichen in einem HTTP-Datenstrom übergeben werden, werden sie möglicherweise am Empfangsende falsch interpretiert. Die URL-Codierung ersetzt Zeichen, die in einer URL nicht zulässig sind, durch Zeichenentsprechungen, die aus hexadezimalen Escapesequenzen bestehen. Die konvertierte Zeichenfolge wird erwartet, dass sie dem UTF-8-Format entspricht.

Die URL-Codierung ersetzt alle Zeichencodes mit Ausnahme von Buchstaben, Zahlen und den folgenden Interpunktionszeichen:

  • - (Minuszeichen)

  • _ (Unterstrich)

  • . (Punkt)

  • ! (Ausrufezeichen)

  • * (Stern)

  • ' (einfaches Anführungszeichen)

  • ( und ) (öffnende und schließende Klammern)

Jedes Zeichen '' (Leerzeichen) wird in ein + (Pluszeichen) konvertiert.

Note

Das Ersetzen von ' ' ' (Leerzeichen) durch ein Pluszeichen (+) wird nur im Abfrageteil des URI (standardmäßig, nicht standardmäßig) oder in application/x-www-form-urlencoded HTTP-Inhalten erwartet. Darüber hinaus entspricht die oben genannte Liste von Zeichen, die nicht ersetzt werden, weder der URL-Spezifikation noch dem URI RFC 3986. Wird für RFC-kompatible Transformation verwendet EscapeDataString .

Wenn sie z. B. in einen Textblock eingebettet werden, der in eine URL übertragen werden soll, werden die Zeichen <> und codiert als %3c und %3e.

Die UrlDecodeToBytes Methode kehrt die Codierung um.

Gilt für: