Uri.GetComponents(UriComponents, UriFormat) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> stringPublic Function GetComponents (components As UriComponents, format As UriFormat) As StringParametri
- 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
Componenti dell'istanza corrente.
Eccezioni
components non è una combinazione di valori di UriComponents validi.
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.