Partager via


Uri.EscapeUriString(String) Méthode

Définition

Attention

Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.

Attention

Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.

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

public:
 static System::String ^ EscapeUriString(System::String ^ stringToEscape);
public static string EscapeUriString (string stringToEscape);
[System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static string EscapeUriString (string stringToEscape);
[System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static string EscapeUriString (string stringToEscape);
static member EscapeUriString : string -> string
[<System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member EscapeUriString : string -> string
[<System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member EscapeUriString : string -> string
Public Shared Function EscapeUriString (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.

Attributs

Exceptions

stringToEscape a la valeur null.

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

Remarque : dans .NET pour les applications Windows Store ou la bibliothèque de classes portables, interceptez l’exception de classe de base, FormatExceptionà la place.

Remarques

Utilisez la EscapeUriString méthode pour préparer une chaîne d’URI non échapée pour qu’elle soit un paramètre pour le Uri constructeur.

Par défaut, la EscapeUriString méthode convertit tous les caractères, sauf les 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 EscapeUriString 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.

S’applique à