Uri.EscapeDataString(String) 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.
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
Représentation d’échappement de stringToEscape
.
Exceptions
stringToEscape
a la valeur null
.
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.