Uri.EscapeUriString(String) Uri.EscapeUriString(String) Uri.EscapeUriString(String) Uri.EscapeUriString(String) Method

Définition

Convertit une chaîne URI en sa représentation sans séquence d'échappement.Converts a URI string to its escaped representation.

public:
 static System::String ^ EscapeUriString(System::String ^ stringToEscape);
public static string EscapeUriString (string stringToEscape);
static member EscapeUriString : string -> string
Public Shared Function EscapeUriString (stringToEscape As String) As String

Paramètres

stringToEscape
String String String String

Chaîne à placer dans une séquence d'échappement.The string to escape.

Retours

String qui contient la représentation avec séquence d'échappement de stringToEscape.A String that contains the escaped representation of stringToEscape.

Exceptions

Dans .NET pour les applications du Windows Store ou la Bibliothèque de classes portable, interceptez l’exception de la classe de base, FormatException, à la place.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

La longueur de stringToEscape dépasse 32 766 caractères.The length of stringToEscape exceeds 32766 characters.

Remarques

Utilisez la EscapeUriString méthode pour préparer une chaîne d’URI sans séquence d’échappement en tant que paramètre Uri du constructeur.Use the EscapeUriString method to prepare an unescaped URI string to be a parameter to the Uri constructor.

Par défaut, la EscapeUriString méthode convertit tous les caractères, à l’exception des caractères non réservés RFC 2396, en leur représentation hexadécimale.By default, the EscapeUriString method converts all characters, except RFC 2396 unreserved characters, to their hexadecimal representation. Si l’analyse des IRI (International Resource Identifiers) ou des IDN (Internationalized Domain Name) est activée EscapeUriString , la méthode convertit tous les caractères, à l’exception des caractères non réservés RFC 3986, en leur représentation hexadécimale.If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the EscapeUriString method converts all characters, except for RFC 3986 unreserved characters, to their hexadecimal representation. Tous les caractères Unicode sont convertis au format UTF-8 avant d’être échappés.All Unicode characters are converted to UTF-8 format before being escaped.

Cette méthode suppose qu' stringToEscape il n’y a pas de séquences d’échappement.This method assumes that stringToEscape has no escape sequences in it.

Par défaut, la chaîne est placée dans une séquence d’échappement conformément à la norme RFC 2396.By default, the string is escaped according to RFC 2396. Si l’analyse des IRI (International Resource Identifiers) ou des IDN (Internationalized Domain Name) est activée, la chaîne est placée dans une séquence d’échappement conformément aux RFC 3986 et RFC 3987.If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the string is escaped according to RFC 3986 and RFC 3987. Consultez ces RFC pour obtenir une définition des caractères réservés et non réservés.See these RFCs for a definition of reserved and unreserved characters.

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

S’applique à