Sdílet prostřednictvím


Uri.EscapeUriString(String) Metoda

Definice

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

Řídicí reprezentace příkazu stringToEscape.

Atributy

Výjimky

stringToEscape je null.

Délka stringToEscape přesahuje 32766 znaků.

    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.

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