Uri.GetComponents(UriComponents, UriFormat) Yöntem
Tanım
Ö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 -> stringPublic Function GetComponents (components As UriComponents, format As UriFormat) As StringParametreler
- 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
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.