Uri.EscapeUriString(String) Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Source:

UriExt.cs

Attenzione

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

Converte una stringa URI nella relativa rappresentazione escape.

public:
 static System::String ^ EscapeUriString(System::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 instead.", 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 di cui effettuare l'escape.

Restituisce

String

Rappresentazione escape di stringToEscape.

Attributi

ObsoleteAttribute

Eccezioni

ArgumentNullException

stringToEscape è null.

UriFormatException

La lunghezza di stringToEscape supera i 32766 caratteri.

    Note: In <a href="https://docs.microsoft.com/previous-versions/br230232(v=vs.110)">.NET for Windows Store apps</a> or the <a href="https://docs.microsoft.com/dotnet/standard/cross-platform/cross-platform-development-with-the-portable-class-library">Portable Class Library</a>, catch the base class exception, <xref data-throw-if-not-resolved="true" uid="System.FormatException"></xref>, instead.

Commenti

Utilizzare il EscapeUriString metodo per preparare una stringa URI senza ambito per essere un parametro per il Uri costruttore.

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

Questo metodo presuppone che stringToEscape non contenga sequenze di escape.

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

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