Uri.EscapeUriString(String) Metodo

Riferimento

Definizione

Spazio dei nomi:: System

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origine:: UriExt.cs

Origine:: UriExt.cs

Origine:: UriExt.cs

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

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://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

Condividi tramite