Uri.GetComponents(UriComponents, UriFormat) Uri.GetComponents(UriComponents, UriFormat) Uri.GetComponents(UriComponents, UriFormat) Uri.GetComponents(UriComponents, UriFormat) Method

Définition

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.Gets the specified components of the current instance using the specified escaping for special characters.

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 UriComponents UriComponents UriComponents

Combinaison d'opérations de bits des valeurs UriComponents qui spécifie quelles parties de l'instance actuelle retourner à l'appelant.A bitwise combination of the UriComponents values that specifies which parts of the current instance to return to the caller.

format
UriFormat UriFormat UriFormat UriFormat

L'une des valeurs UriFormat qui contrôlent la façon dont les caractères spéciaux sont placés dans une séquence d'échappement.One of the UriFormat values that controls how special characters are escaped.

Retours

String qui contient les composants.A String that contains the components.

Exceptions

components n'est pas une combinaison de valeurs UriComponents valides.components is not a combination of valid UriComponents values.

Uri actuel n'est pas un URI absolu.The current Uri is not an absolute URI. Il est impossible d'utiliser des URI relatifs avec cette méthode.Relative URIs cannot be used with this method.

Remarques

Les composants Query, Fragment, Scheme, UserInfo, Host, Port et Path n’incluent pas le délimiteur.The Query, Fragment, Scheme, UserInfo, Host, Port, and Path components do not include the delimiter. Vous pouvez combiner l’indicateur KeepDelimiter (à l’aide de l’opérateur or au niveau du bit) avec l’une de ces valeurs pour récupérer la valeur avec le délimiteur.You can combine the KeepDelimiter flag (using the bitwise OR operator) with any of those values to get the value with the delimiter. Pour toutes les autres valeurs UriComponents, et les combinaisons de valeurs, les délimiteurs sont inclus dans la valeur retournée.For all other UriComponents values, and combinations of values, the delimiters are included in the returned value.

Les composants sont retournés dans l’ordre dans lequel ils apparaissent dans l’URI.The components are returned in the order that they appear in the URI. Par exemple, si Scheme est spécifié, il s’affiche en premier.For example, if Scheme is specified, it appears first.

Lorsque la prise en charge des IRI (International Resource Identifier) et des IDN (Internationalized Domain Name) est activée, le nombre de caractères retournés dans le String augmente.When International Resource Identifier (IRI) and Internationalized Domain Name (IDN) support are enabled, the number of characters returned in the String increases. Les noms Punycode utilisés pour prendre en charge les IRI contiennent uniquement des caractères ASCII et commencent toujours par le préfixe xn--.Punycode names used to support IRI contain only ASCII characters and always start with the xn-- prefix. Lorsque les IRI et les IDN sont activés, les caractères de substitution Unicode sont gérés correctement par la méthode GetComponents.When IRI and IDN are enabled, Unicode surrogate characters are handled correctly by the GetComponents method.

Pour plus d’informations sur la prise en charge des IRI, consultez la section Notes pour la classe Uri.For more information on IRI support, see the Remarks section for the Uri class.

Notes

Si la méthode GetComponents est appelée avec format ayant la valeur Unescaped, vous ne pouvez pas utiliser la valeur de retour en tant qu’argument d’un constructeur Uri pour créer un @no__t équivalent-4.If the GetComponents method is called with format set to Unescaped , you cannot use the return value as an argument to a Uri constructor to create an equivalent Uri.

S’applique à