Uri.EscapeUriString(String) Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Zdroj:: UriExt.cs

Zdroj:: UriExt.cs

Zdroj:: UriExt.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Upozornění

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

Upozornění

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

Převede řetězec identifikátoru URI na jeho řídicí reprezentaci.

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

Parametry

stringToEscape: String

Řetězec, který se má utéct.

Návraty

String

Řídicí reprezentace příkazu stringToEscape.

Atributy: ObsoleteAttribute

Výjimky

ArgumentNullException

stringToEscape je null.

UriFormatException

Délka stringToEscape přesahuje 32766 znaků.

    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.

Poznámky

EscapeUriString Pomocí metody připravte řetězec identifikátoru URI bez panoramatu, který bude parametrem konstruktoruUri.

Ve výchozím nastavení EscapeUriString metoda převede všechny znaky s výjimkou nererezervovaných znaků RFC 2396 na jejich šestnáctkové vyjádření. Pokud je povolená EscapeUriString analýza mezinárodních identifikátorů prostředků (IRI) nebo internationalizovaného názvu domény (IDN), převede metoda všechny znaky, s výjimkou nererezervovaných znaků RFC 3986, na jejich šestnáctkovou reprezentaci. Všechny znaky Unicode se před řídicím příkazem převedou do formátu UTF-8.

Tato metoda předpokládá, že stringToEscape neobsahuje žádné řídicí sekvence.

Ve výchozím nastavení je řetězec u řídicího řetězce podle RFC 2396. Pokud je povolená parsování mezinárodních identifikátorů prostředků (IRI) nebo internationalizovaného názvu domény (IDN), řetězec se uchytá podle RFC 3986 a RFC 3987. Definice rezervovaných a nerezervovaných znaků najdete v těchto dokumentech RFC.

Další informace o podpoře IRI najdete v části Poznámky pro třídu Uri .

Platí pro