Uri.GetComponents(UriComponents, UriFormat) Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

UriExt.cs

Získá zadané součásti aktuální instance pomocí zadané escaping pro speciální znaky.

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

Bitové kombinace UriComponents hodnot, které určují, které části aktuální instance se mají vrátit volajícímu.

format

UriFormat

Jedna z hodnot výčtu, která určuje, jak jsou speciální znaky řídicí znaky.

Návraty

String

Komponenty aktuální instance.

Výjimky

ArgumentOutOfRangeException

components není kombinací platných UriComponents hodnot.

InvalidOperationException

Aktuální Uri hodnota není absolutní identifikátor URI. Relativní identifikátory URI nelze s touto metodou použít.

Poznámky

Znak Query, , FragmentScheme, UserInfo, HostPorta Path součásti nezahrnují oddělovač. Příznak (pomocí bitového operátoru KeepDelimiter OR) můžete zkombinovat s libovolnou z těchto hodnot, abyste získali hodnotu s oddělovačem. Pro všechny ostatní UriComponents hodnoty a kombinace hodnot jsou oddělovače zahrnuty do vrácené hodnoty.

Komponenty se vrátí v pořadí, v jakém se zobrazují v identifikátoru URI. Pokud je například zadán, Scheme zobrazí se jako první.

Pokud je povolená podpora International Resource Identifier (IRI) a Internationalized Domain Name (IDN), počet znaků vrácených v nárůstu String . Punycode names used to support IRI contain only ASCII characters and always start with the xn-- prefix. Pokud jsou povoleny IRI a IDN, náhradní znaky Unicode jsou zpracovány správně metodou GetComponents .

Další informace o podpoře IRI naleznete v části Poznámky pro Uri třídu.

Note

GetComponents Pokud je volána metoda s nastavenou formatUnescaped na , nelze použít návratovou hodnotu jako argument Uri konstruktor vytvořit ekvivalentní Uri.