Uri.GetComponents(UriComponents, UriFormat) Méthode

Définition

Espace de noms:
System
Assemblys:
System.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs

Obtient les composants spécifiés de l’instance actuelle à l’aide de l’échappement spécifié 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 au niveau du bit des UriComponents valeurs qui spécifie les parties de l’instance actuelle à retourner à l’appelant.

format
UriFormat

Une des valeurs d’énumération qui contrôle la façon dont les caractères spéciaux sont échappés.

Retours

String

Composants de l’instance actuelle.

Exceptions

ArgumentOutOfRangeException

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

InvalidOperationException

Le courant Uri n’est pas un URI absolu. Les URI relatifs ne peuvent pas être utilisés avec cette méthode.

Remarques

Les Querycomposants , FragmentSchemeUserInfoHostPortPathet 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, si Scheme elle est spécifiée, elle apparaît en premier.

Lorsque la prise en charge de l’identificateur de ressource international (IRI) et du nom de domaine internationalisé (IDN) 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 pour la Uri classe.

Note

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

S’applique à