Uri.EscapeUriString(String) Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

UriExt.cs

Perhatian

Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.

Mengonversi string URI ke representasi yang lolos.

public:
 static System::String ^ EscapeUriString(System::String ^ stringToEscape);

[System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static string EscapeUriString (string stringToEscape);

[<System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member EscapeUriString : string -> string

Public Shared Function EscapeUriString (stringToEscape As String) As String

Parameter

stringToEscape

String

String yang akan dilewati.

Mengembalikan

String

Representasi yang lolos dari stringToEscape.

Atribut

ObsoleteAttribute

Pengecualian

ArgumentNullException

stringToEscapeadalah null.

UriFormatException

Panjang stringToEscape melebihi 32766 karakter.

    Note: In <a href="https://docs.microsoft.com/previous-versions/br230232(v=vs.110)">.NET for Windows Store apps</a> or the <a href="https://docs.microsoft.com/dotnet/standard/cross-platform/cross-platform-development-with-the-portable-class-library">Portable Class Library</a>, catch the base class exception, <xref data-throw-if-not-resolved="true" uid="System.FormatException"></xref>, instead.

Keterangan

EscapeUriString Gunakan metode untuk menyiapkan string URI yang tidak dilewati untuk menjadi parameter ke Uri konstruktor.

Secara default, metode mengonversi EscapeUriString semua karakter, kecuali karakter RFC 2396 yang tidak dilayani, ke representasi heksadesimalnya. Jika penguraian International Resource Identifiers (IRIs) atau Internationalized Domain Name (IDN) diaktifkan, EscapeUriString metode mengonversi semua karakter, kecuali untuk karakter RFC 3986 yang belum dilayani, ke representasi heksadesimalnya. Semua karakter Unicode dikonversi ke format UTF-8 sebelum diloloskan.

Metode ini mengasumsikan bahwa stringToEscape tidak memiliki urutan escape di dalamnya.

Secara default, string lolos sesuai dengan RFC 2396. Jika pengidentifikasi Sumber Daya Internasional (IRIs) atau penguraian Nama Domain Internasional (IDN) diaktifkan, string akan lolos sesuai dengan RFC 3986 dan RFC 3987. Lihat RFC ini untuk definisi karakter yang dicadangkan dan belum dilayani.

Untuk informasi selengkapnya tentang dukungan IRI, lihat bagian Keterangan untuk Uri kelas .