Uri.GetComponents(UriComponents, UriFormat) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera określone składniki bieżącego wystąpienia przy użyciu określonego ucieczki dla znaków specjalnych.

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

Parametry

components: UriComponents

Bitowa kombinacja UriComponents wartości określających, które części bieżącego wystąpienia mają powrócić do obiektu wywołującego.

format: UriFormat

Jedna z wartości wyliczenia, która kontroluje sposób ucieczki znaków specjalnych.

Zwraca

String

Składniki bieżącego wystąpienia.

Wyjątki

ArgumentOutOfRangeException

components nie jest kombinacją prawidłowych UriComponents wartości.

InvalidOperationException

Bieżący Uri nie jest bezwzględnym identyfikatorem URI. Względne identyfikatory URI nie mogą być używane z tą metodą.

Uwagi

Składniki Query, , Scheme Host Port Fragment UserInfoi Path nie zawierają ogranicznika. Możesz połączyć flagę KeepDelimiter (przy użyciu operatora bitowego OR) z dowolną z tych wartości, aby uzyskać wartość z ogranicznikiem. Dla wszystkich innych UriComponents wartości i kombinacji wartości ograniczniki są uwzględniane w zwracanej wartości.

Składniki są zwracane w kolejności, w której są wyświetlane w identyfikatorze URI. Jeśli na przykład Scheme zostanie określony, zostanie wyświetlony jako pierwszy.

Po włączeniu obsługi międzynarodowych identyfikatorów zasobów (IRI) i międzynarodowych nazw domen (IDN) liczba znaków zwracanych w String tym zakresie. Nazwy punycode używane do obsługi IRI zawierają tylko znaki ASCII i zawsze zaczynają się od xn-- prefiks. Po włączeniu funkcji IRI i IDN znaki zastępcze Unicode są obsługiwane poprawnie przez metodę GetComponents .

Aby uzyskać więcej informacji na temat obsługi IRI, zobacz sekcję Uri Uwagi dla klasy.

Uwaga

Jeśli metoda jest wywoływana GetComponents z ustawioną wartością Unescaped format , nie można użyć wartości zwracanej jako argumentu do konstruktora Uri w celu utworzenia równoważnego Urielementu .

Dotyczy