Uri.GetComponents(UriComponents, UriFormat) Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Ottiene i componenti specificati dell'istanza corrente usando l'escape specificato per caratteri speciali.

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

Parametri

components

UriComponents

Combinazione bit per bit dei valori di UriComponents che specifica quali parti dell'istanza corrente restituire al chiamante.

format

UriFormat

Uno dei valori dell'enumerazione che controlla la modalità di escape dei caratteri speciali.

Restituisce

String

Componenti dell'istanza corrente.

Eccezioni

ArgumentOutOfRangeException

components non è una combinazione di valori di UriComponents validi.

InvalidOperationException

L'oggetto Uri corrente non è un URI assoluto. Non è possibile utilizzare URI relativi con questo metodo.

Commenti

I Querycomponenti , Fragment, UserInfoScheme, Host, Port, e Path non includono il delimitatore. È possibile combinare il KeepDelimiter flag (usando l'operatore OR bit per bit) con uno qualsiasi di questi valori per ottenere il valore con il delimitatore. Per tutti gli altri UriComponents valori e le combinazioni di valori, i delimitatori vengono inclusi nel valore restituito.

I componenti vengono restituiti nell'ordine in cui vengono visualizzati nell'URI. Ad esempio, se Scheme viene specificato, viene visualizzato per primo.

Quando è abilitato il supporto IRI (International Resource Identifier) e IDN (Internationalized Domain Name), aumenta il numero di caratteri restituiti String . I nomi punycode usati per supportare IRI contengono solo caratteri ASCII e iniziano sempre con il prefisso xn-- . Quando l'IRI e l'IDN sono abilitati, i caratteri surrogati Unicode vengono gestiti correttamente dal GetComponents metodo .

Per altre informazioni sul supporto IRI, vedere la sezione Osservazioni per la Uri classe .

Nota

Se il GetComponents metodo viene chiamato con format impostato su Unescaped , non è possibile usare il valore restituito come argomento per un Uri costruttore per creare un oggetto equivalente Uri.