Uri.GetComponents(UriComponents, UriFormat) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> stringPublic Function GetComponents (components As UriComponents, format As UriFormat) As StringParamè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
Composants de l’instance actuelle.
Exceptions
components n'est pas une combinaison de valeurs UriComponents valides.
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.