Uri.EscapeDataString(String) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Convertit une chaîne en sa représentation avec séquence d'échappement.

public:
 static System::String ^ EscapeDataString(System::String ^ stringToEscape);

public static string EscapeDataString (string stringToEscape);

static member EscapeDataString : string -> string

Public Shared Function EscapeDataString (stringToEscape As String) As String

Paramètres

stringToEscape

String

Chaîne à placer dans une séquence d'échappement.

Retours

String

Représentation d’échappement de stringToEscape.

Exceptions

ArgumentNullException

stringToEscape a la valeur null.

UriFormatException

Remarque : Dans .NET pour les applications du Windows Store ou la Bibliothèque de classes portable, interceptez plutôt l’exception de la classe de base FormatException.

La longueur de stringToEscape dépasse 32 766 caractères.

Remarques

Par défaut, la EscapeDataString méthode convertit tous les caractères à l’exception des caractères non réservés RFC 2396 en leur représentation hexadécimale. Si l’analyse IDN (International Resource Identifiers) ou INTERNATIONALized Domain Name (IDN) est activée, la EscapeDataString méthode convertit tous les caractères, à l’exception des caractères non réservés RFC 3986, en leur représentation hexadécimale. Tous les caractères Unicode sont convertis au format UTF-8 avant d’être placés dans une séquence d’échappement.

Cette méthode suppose qu’elle stringToEscape n’a pas de séquences d’échappement.

Par défaut, la chaîne est placée dans une séquence d’échappement selon RFC 2396. Si l’analyse IDN (International Resource Identifiers) ou Internationalized Domain Name (IDN) est activée, la chaîne est échappée selon RFC 3986 et RFC 3987. Consultez ces RFC pour obtenir une définition de caractères réservés et non réservés.

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