Uri.EscapeUriString(String) Metodo

Definizione

Attenzione

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

Attenzione

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

Converte una stringa URI nella relativa rappresentazione di escape.

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

Parametri

stringToEscape
String

Stringa a cui aggiungere i caratteri di escape.

Valori restituiti

Rappresentazione di escape di stringToEscape.

Attributi

Eccezioni

stringToEscape è null.

solo .NET Framework: la lunghezza di stringToEscape supera i 32766 caratteri.

Commenti

Utilizzare il EscapeUriString metodo per preparare una stringa URI senza caratteri di escape come parametro per il Uri costruttore.

Per impostazione predefinita, il EscapeUriString metodo converte tutti i caratteri, ad eccezione dei caratteri RFC 2396 senza riserva, nella rappresentazione esadecimale. Se l'analisi IDN (International Resource Identifiers) o Internationalized Domain Name (IDN) è abilitata, il EscapeUriString metodo converte tutti i caratteri, ad eccezione dei caratteri RFC 3986 senza riserva, nella relativa rappresentazione esadecimale. Tutti i caratteri Unicode vengono convertiti in formato UTF-8 prima di essere preceduti da un carattere di escape.

Questo metodo presuppone che stringToEscape non contenga sequenze di escape.

Per impostazione predefinita, la stringa viene preceduta da un escape in base a RFC 2396. Se è abilitata l'analisi IDN (International Resource Identifiers) o Internationalized Domain Name (IDN), la stringa viene preceduta da un carattere di escape in base a RFC 3986 e RFC 3987. Per una definizione di caratteri riservati e non riservati, vedere queste RFC.

Per altre informazioni sul supporto IRI, vedere la sezione Osservazioni per la Uri classe .

Si applica a