Uri.GetComponents(UriComponents, UriFormat) Metoda
Definicja
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 -> stringPublic Function GetComponents (components As UriComponents, format As UriFormat) As StringParametry
- 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
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 .