WebUtility.UrlEncode(String) Methode

Definition

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

Konvertiert eine Textzeichenfolge in eine URL-codierte Zeichenfolge.

public:
 static System::String ^ UrlEncode(System::String ^ value);
public static string UrlEncode(string value);
static member UrlEncode : string -> string
Public Shared Function UrlEncode (value As String) As String

Parameter

value
String

Der Text zur URL-Codierung.

Gibt zurück

String

Eine URL-codierte Zeichenfolge.

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)

  • ( 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 UrlDecode Methode kehrt die Codierung um.

Gilt für: