Uri.EscapeUriString(String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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://video2.skills-academy.com/previous-versions/br230232(v=vs.110)">.NET for Windows Store apps</a> or the <a href="https://video2.skills-academy.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.