Uri.EscapeComponent(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Konvertiert eine URI-Zeichenfolge (Uniform Resource Identifier) in ihre Escapedarstellung.
public:
static Platform::String ^ EscapeComponent(Platform::String ^ toEscape); static winrt::hstring EscapeComponent(winrt::hstring const& toEscape);public static string EscapeComponent(string toEscape);function escapeComponent(toEscape)Public Shared Function EscapeComponent (toEscape As String) As StringParameter
- toEscape
-
String
Platform::String
winrt::hstring
Die zu konvertierende Zeichenfolge.
Gibt zurück
Die Escapedarstellung von toEscape.
Hinweise
Verwenden Sie EscapeComponent als Hilfsprogramm, um eine beliebige URI-Komponente (Uniform Resource Identifier) mit Escapezeichen zu versehen, die escapen muss, um ein gültiges URI-Objekt zu erstellen. Wenn Ihre App z. B. eine vom Benutzer bereitgestellte Zeichenfolge verwendet und sie einer Abfrage hinzufügt, die an einen Dienst gesendet wird, müssen Sie diese Zeichenfolge möglicherweise im URI (Uniform Resource Identifier) mit Escapezeichen versehen, da die Zeichenfolge zeichen enthalten kann, die in einem URI (Uniform Resource Identifier) ungültig sind. Dies schließt einfache Zeichen wie Leerzeichen ein; Selbst Eingaben, die reines ASCII-Format zu sein scheinen, müssen möglicherweise noch Codierungen benötigen, um als Komponente eines URI (Uniform Resource Identifier) gültig zu sein.
Sie können die aus EscapeComponent abgerufene Zeichenfolge an andere Zeichenfolgen anfügen, bevor Sie den Uri(String)-Konstruktor aufrufen. Sie sollten jede Komponente separat codieren, da Sie nicht die Zeichen mit Escapezeichen versehen möchten, die für die Analyse der Zeichenfolge durch den Uri(String)-Konstruktor in Komponenten relevant sind, z. B. das "/" zwischen Host und Pfad oder das "?" zwischen Pfad und Abfrage.
EscapeComponent kann auch für andere Szenarien nützlich sein, in denen eine URI-Escapezeichenfolge (Uniform Resource Identifier) für ein HTTP-Anforderungsszenario benötigt wird, z. B. die Verwendung von APIs im Windows.Web.Http-Namespace .