Uri.GetComponents(UriComponents, UriFormat) Yöntem

Başvuru

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Özel karakterler için belirtilen kaçışı kullanarak geçerli örneğin belirtilen bileşenlerini alır.

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

Parametreler

components: UriComponents

Geçerli örneğin hangi bölümlerinin UriComponents çağırana döndürüleceği belirten değerlerin bit düzeyinde birleşimi.

format: UriFormat

Özel karakterlerin kaçışını denetleen numaralandırma değerlerinden biri.

Döndürülenler

String

Geçerli örneğin bileşenleri.

Özel durumlar

ArgumentOutOfRangeException

components geçerli UriComponents değerlerin birleşimi değildir.

InvalidOperationException

Geçerli Uri mutlak bir URI değil. Göreli URI'ler bu yöntemle kullanılamaz.

Açıklamalar

Query, , Fragment, Scheme, UserInfo, Host, Portve Path bileşenleri sınırlayıcıyı içermez. Sınırlayıcı ile KeepDelimiter değeri almak için bayrağını (bit düzeyinde OR işlecini kullanarak) bu değerlerden herhangi biriyle birleştirebilirsiniz. Diğer UriComponents tüm değerler ve değer birleşimleri için sınırlayıcılar döndürülen değere dahil edilir.

Bileşenler URI'de göründükleri sırayla döndürülür. Örneğin, belirtilirse Scheme ilk olarak görünür.

Uluslararası Kaynak Tanımlayıcısı (IRI) ve UluslararasıLaştırılmış Etki Alanı Adı (IDN) desteği etkinleştirildiğinde, döndürülen String karakter sayısı artar. IRI'yi desteklemek için kullanılan punycode adları yalnızca ASCII karakterler içerir ve her zaman xn-- ön ekiyle başlar. IRI ve IDN etkinleştirildiğinde, Unicode vekil karakterleri yöntemi tarafından GetComponents doğru işlenir.

IRI desteği hakkında daha fazla bilgi için Uri sınıfın Açıklamalar bölümüne bakın.

Not

GetComponents yöntemi değerine ayarlanmış Unescaped olarak çağrılırsaformat, eşdeğer Uribir Uri oluşturmak için bir oluşturucuya bağımsız değişken olarak dönüş değerini kullanamazsınız.

Şunlara uygulanır