Uri.GetComponents(UriComponents, UriFormat) Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Sestavení:

System.dll

Sestavení:

netstandard.dll

Získá zadané komponenty 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í.

Návraty

String

Komponenty aktuální instance.

Výjimky

ArgumentOutOfRangeException

components není kombinací platných UriComponents hodnot.

InvalidOperationException

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

Poznámky

Znak Query, Fragment, Scheme, UserInfoHost, Porta Path součásti nezahrnují oddělovač. Příznak (pomocí bitového operátoru OR) můžete zkombinovat KeepDelimiter s libovolnou z těchto hodnot, abyste získali hodnotu 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 Scheme zadán, zobrazí se jako první.

Pokud je povolená podpora identifikátoru IRI (International Resource Identifier) 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ávány správně metodou GetComponents .

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

Poznámka

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