Uri.GetComponents(UriComponents, UriFormat) Metode

Definisi

Ruang nama:

System

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

UriExt.cs

Mendapatkan komponen yang ditentukan dari instans saat ini menggunakan pelepasan yang ditentukan untuk karakter khusus.

public:
 System::String ^ GetComponents(UriComponents components, UriFormat format);

public string GetComponents(UriComponents components, UriFormat format);

member this.GetComponents : UriComponents * UriFormat -> string

Public Function GetComponents (components As UriComponents, format As UriFormat) As String

Parameter

components

UriComponents

Kombinasi bitwise dari UriComponents nilai yang menentukan bagian mana dari instans saat ini yang akan dikembalikan ke pemanggil.

format

UriFormat

Salah satu nilai enumerasi yang mengontrol bagaimana karakter khusus lolos.

Mengembalikan

String

Komponen instans saat ini.

Pengecualian

ArgumentOutOfRangeException

components bukan kombinasi nilai yang valid UriComponents .

InvalidOperationException

Saat ini Uri bukan URI absolut. URI relatif tidak dapat digunakan dengan metode ini.

Keterangan

Komponen Query, , FragmentScheme, UserInfoHost, Port, dan Path tidak menyertakan pemisah. Anda dapat menggabungkan KeepDelimiter bendera (menggunakan operator BITWISE OR) dengan salah satu nilai tersebut untuk mendapatkan nilai dengan pemisah. Untuk semua nilai lainnya UriComponents , dan kombinasi nilai, pemisah disertakan dalam nilai yang dikembalikan.

Komponen dikembalikan dalam urutan muncul di URI. Misalnya, jika Scheme ditentukan, itu muncul terlebih dahulu.

Ketika dukungan Pengidentifikasi Sumber Daya Internasional (IRI) dan Nama Domain Internasional (IDN) diaktifkan, jumlah karakter yang dikembalikan dalam String peningkatan. Nama punycode yang digunakan untuk mendukung IRI hanya berisi karakter ASCII dan selalu dimulai dengan awalan xn-- . Ketika IRI dan IDN diaktifkan, karakter pengganti Unicode ditangani dengan benar oleh GetComponents metode .

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

Note

Jika metode dipanggil GetComponents dengan format diatur ke Unescaped , Anda tidak dapat menggunakan nilai pengembalian sebagai argumen ke Uri konstruktor untuk membuat yang setara Uri.