Aracılığıyla paylaş


Uri.GetComponents(UriComponents, UriFormat) Yöntem

Tanım

Ö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

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

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