Uri.EscapeComponent(String) Methode

Definition

Namespace:

Windows.Foundation

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 String

Parameter

toEscape

String

Platform::String

winrt::hstring

Die zu konvertierende Zeichenfolge.

Gibt zurück

String

Platform::String

winrt::hstring

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 .

Weitere Informationen

• Uri(String)