Share via


Uri.EscapeComponent(String) Metode

Definisi

Mengonversi string Pengidentifikasi Sumber Daya Seragam (URI) ke representasi yang lolos.

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

String yang akan dikonversi.

Mengembalikan

String

Platform::String

winrt::hstring

Representasi toEscape yang lolos.

Keterangan

Gunakan EscapeComponent sebagai utilitas untuk menghindari komponen Pengidentifikasi Sumber Daya Seragam (URI) yang memerlukan pelepasan untuk membuat objek Uri yang valid. Misalnya, jika aplikasi Anda menggunakan string yang disediakan pengguna dan menambahkannya ke kueri yang dikirim ke layanan, Anda mungkin perlu menghindari string tersebut di Pengidentifikasi Sumber Daya Seragam (URI) karena string mungkin berisi karakter yang tidak valid dalam Pengidentifikasi Sumber Daya Seragam (URI). Ini termasuk karakter sesingkat spasi; bahkan input yang tampaknya ASCII murni mungkin masih memerlukan pengodean agar valid sebagai komponen Pengidentifikasi Sumber Daya Seragam (URI).

Anda dapat menambahkan string yang Anda dapatkan dari EscapeComponent ke string lain sebelum memanggil konstruktor Uri(String). Anda akan ingin mengodekan setiap komponen secara terpisah, karena Anda tidak ingin keluar dari karakter yang signifikan dengan bagaimana konstruktor Uri(String) menguraikan string ke dalam komponen, seperti "/" antara host dan jalur atau "?" antara jalur dan kueri.

EscapeComponent mungkin juga berguna untuk skenario lain di mana string escaped Pengidentifikasi Sumber Daya Seragam (URI) diperlukan untuk skenario permintaan HTTP, seperti menggunakan API di namespace Windows.Web.Http .

Berlaku untuk

Lihat juga