Uri.GetComponents(UriComponents, UriFormat) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

UriExt.cs

Ö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üldüğünü 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 eklenir.

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ı 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 şekilde 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.

Note

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