Langage

Uri.EscapeUriString(String) Méthode

Définition

Espace de noms:
System
Assemblys:
System.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs

Attention

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

Attention

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

Convertit une chaîne d’URI en sa représentation 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 instead.", 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.", 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 instead.", 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.", 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 d'échappement.

Retours

String

Représentation échappée de stringToEscape.

Attributs
ObsoleteAttribute

Exceptions

ArgumentNullException

stringToEscape a la valeur null.

UriFormatException

.NET Framework uniquement : la longueur de stringToEscape dépasse 32766 caractères.

Remarques

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

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. 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 l’échappement.

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

Par défaut, la chaîne est échappée 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 pour la Uri classe.

S’applique à