Freigeben über


WebUtility.UrlEncode(String) Methode

Definition

Konvertiert eine Textzeichenfolge in eine URL-codierte Zeichenfolge.

public:
 static System::String ^ UrlEncode(System::String ^ value);
public static string UrlEncode (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 als URL zu codierende Text.

Gibt zurück

Eine URL-codierte Zeichenfolge.

Hinweise

Wenn Zeichen wie Leerzeichen und Interpunktion in einem HTTP-Stream übergeben werden, werden sie möglicherweise am empfangenden Ende falsch interpretiert. Die URL-Codierung ersetzt Zeichen, die in einer URL nicht zulässig sind, durch Zeichenentitätsäquivalente, die aus hexadezimalen Escapesequenzen bestehen. Es wird erwartet, dass die konvertierte Zeichenfolge dem UTF-8-Format entspricht.

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

  • - (Minuszeichen)

  • _ (Unterstrich)

  • . (Punkt)

  • ! (Ausrufezeichen)

  • * (Sternchen)

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

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

Wenn Sie beispielsweise in einen Textblock eingebettet werden, der in einer URL übertragen werden soll, werden die Zeichen < und > als %3c und %3ecodiert.

Die UrlDecode -Methode kehrt die Codierung um.

Gilt für: