Condividi tramite


Uri.EscapeUriString(String) Metodo

Definizione

Attenzione

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

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);
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

Parametri

stringToEscape
String

Stringa di cui effettuare l'escape.

Restituisce

Rappresentazione escape di stringToEscape.

Attributi

Eccezioni

stringToEscape è null.

La lunghezza di stringToEscape supera i 32766 caratteri.

    Note: In <a href="https://learn.microsoft.com/previous-versions/br230232(v=vs.110)">.NET for Windows Store apps</a> or the <a href="https://learn.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.

Si applica a