Uri.EscapeDataString(String) Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Sestavení:

System.dll

Sestavení:

netstandard.dll

Převede řetězec na řídicí reprezentaci.

public:
 static System::String ^ EscapeDataString(System::String ^ stringToEscape);

public static string EscapeDataString (string stringToEscape);

static member EscapeDataString : string -> string

Public Shared Function EscapeDataString (stringToEscape As String) As String

Parametry

stringToEscape

String

Řetězec k řídicímu znaku.

Návraty

String

Řídicí reprezentace stringToEscape.

Výjimky

ArgumentNullException

stringToEscape je null.

UriFormatException

Poznámka: V .NET pro aplikace Windows Store nebo přenosné knihovny tříd zachyťte výjimku základní třídy , FormatExceptionmísto toho.

Délka stringToEscape překračuje 32766 znaků.

Poznámky

Ve výchozím nastavení EscapeDataString metoda převede všechny znaky kromě RFC 2396 nereservovaných znaků na jejich šestnáctkové vyjádření. Pokud je povolené parsování mezinárodních identifikátorů prostředků (IRI) nebo internationalizovaného názvu domény (IDN), EscapeDataString metoda převede všechny znaky s výjimkou nevyužitých znaků RFC 3986 na šestnáctkové vyjádření. Všechny znaky Unicode jsou před řídicím znakem převedeny na formát UTF-8.

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

Ve výchozím nastavení je řetězec řídicím znakem 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. Tyto dokumenty RFC najdete v definici rezervovaných a nereservovaných znaků.

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