Udostępnij za pośrednictwem


Uri.GetComponents(UriComponents, UriFormat) Metoda

Definicja

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

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

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, , SchemeHostPortFragmentUserInfoi 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