Uri.EscapeUriString(String) Metoda

Definice

Obor názvů:
System
Sestavení:
System.dll, System.Runtime.dll
Sestavení:
netstandard.dll, System.Runtime.dll
Sestavení:
System.Runtime.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll
Zdroj:
UriExt.cs
Zdroj:
UriExt.cs
Zdroj:
UriExt.cs
Zdroj:
UriExt.cs
Zdroj:
UriExt.cs

Upozornění

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

Upozornění

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

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 instead.", 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.", 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 instead.", 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.", 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 k řídicímu znaku.

Návraty

String

Řídicí reprezentace stringToEscape.

Atributy
ObsoleteAttribute

Výjimky

ArgumentNullException

stringToEscape je null.

UriFormatException

pouze .NET Framework: Délka stringToEscape překračuje 32766 znaků.

Poznámky

EscapeUriString Pomocí metody připravte unescaped URI řetězec být parametr konstruktoruUri.

Ve výchozím nastavení EscapeUriString metoda převede všechny znaky, s výjimkou RFC 2396 nereservovaných znaků, na jejich šestnáctkové vyjádření. Pokud je povolené EscapeUriString parsování international resource identifiers (IRI) nebo Internationalized Domain Name (IDN), metoda převede všechny znaky s výjimkou nereservovaných znaků RFC 3986 na jejich šestnáctkové vyjádření. Všechny znaky Unicode se před řídicími znaky převedou do formátu UTF-8.

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

Ve výchozím nastavení je řetězec uchvácen podle dokumentu 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 umiskne podle RFC 3986 a RFC 3987. V těchto dokumentech RFC najdete definici rezervovaných a nevyhrazených znaků.

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

Platí pro