Uri.EscapeComponent(String) Metodo

Definizione

Spazio dei nomi:

Windows.Foundation

Converte una stringa URI (Uniform Resource Identifier) nella relativa rappresentazione di escape.

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

Parametri

toEscape

String

Platform::String

winrt::hstring

Stringa da convertire.

Restituisce

String

Platform::String

winrt::hstring

Rappresentazione di escape di toEscape.

Commenti

Usare EscapeComponent come utilità per eseguire l'escape di qualsiasi componente URI (Uniform Resource Identifier) che richiede l'escape per costruire un oggetto Uri valido. Ad esempio, se l'app usa una stringa fornita dall'utente e la aggiunge a una query inviata a un servizio, potrebbe essere necessario eseguire l'escape di tale stringa nell'URI (Uniform Resource Identifier) perché la stringa potrebbe contenere caratteri non validi in un URI (Uniform Resource Identifier). Sono inclusi caratteri semplici come spazi; anche l'input che sembra essere puro ASCII potrebbe comunque dover essere valida come componente di un URI (Uniform Resource Identifier).

È possibile aggiungere la stringa ottenuta da EscapeComponent ad altre stringhe prima di chiamare il costruttore Uri(String). È consigliabile codificare ogni componente separatamente, perché non si vuole eseguire l'escape dei caratteri significativi per il modo in cui il costruttore Uri(String) analizza la stringa in componenti, ad esempio "/" tra host e percorso o "?" tra percorso e query.

EscapeComponent può essere utile anche per altri scenari in cui è necessaria una stringa con escape URI (Uniform Resource Identifier) per uno scenario di richiesta HTTP, ad esempio l'uso di API nello spazio dei nomi Windows.Web.Http .

Vedi anche

• Uri(String)