Uri.GetComponents(UriComponents, UriFormat) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Obtient les composants spécifiés de l'instance actuelle à l'aide de la séquence d'échappement spécifiée pour les caractères spéciaux.

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

Paramètres

components

UriComponents

Combinaison d'opérations de bits des valeurs UriComponents qui spécifie quelles parties de l'instance actuelle retourner à l'appelant.

format

UriFormat

L’une des valeurs d’énumération qui contrôle l’échappement des caractères spéciaux.

Retours

String

Composants de l’instance actuelle.

Exceptions

ArgumentOutOfRangeException

components n'est pas une combinaison de valeurs UriComponents valides.

InvalidOperationException

Uri actuel n'est pas un URI absolu. Il est impossible d'utiliser des URI relatifs avec cette méthode.

Remarques

Les Querycomposants , SchemeHostPortFragmentUserInfoet Path les composants n’incluent pas le délimiteur. Vous pouvez combiner l’indicateur KeepDelimiter (à l’aide de l’opérateur OR au niveau du bit) avec l’une de ces valeurs pour obtenir la valeur avec le délimiteur. Pour toutes les autres UriComponents valeurs et combinaisons de valeurs, les délimiteurs sont inclus dans la valeur retournée.

Les composants sont retournés dans l’ordre dans lequel ils apparaissent dans l’URI. Par exemple, s’il Scheme est spécifié, il apparaît en premier.

Lorsque la prise en charge d’IRI (International Resource Identifier) et d’IDN (InternationalIzed Domain Name) est activée, le nombre de caractères retournés dans les String augmentations. Les noms Punycode utilisés pour prendre en charge IRI contiennent uniquement des caractères ASCII et commencent toujours par le préfixe xn. Lorsque IRI et IDN sont activés, les caractères de substitution Unicode sont gérés correctement par la GetComponents méthode.

Pour plus d’informations sur la prise en charge de l’IRI, consultez la section Notes de la Uri classe.

Notes

Si la GetComponents méthode est appelée avec format la valeur définie Unescaped , vous ne pouvez pas utiliser la valeur de retour comme argument d’un Uri constructeur pour créer un équivalent Uri.