Język

Uri.EscapeUriString(String) Metoda

Definicja

Przestrzeń nazw:
System
Zestawy:
System.dll, System.Runtime.dll
Zestawy:
netstandard.dll, System.Runtime.dll
Zestaw:
System.Runtime.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll
Źródło:
UriExt.cs
Źródło:
UriExt.cs
Źródło:
UriExt.cs
Źródło:
UriExt.cs
Źródło:
UriExt.cs

Uwaga

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

Uwaga

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

Konwertuje ciąg identyfikatora URI na jego unikniętą reprezentację.

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

Ciąg do ucieczki.

Zwraca

String

Unikniętą reprezentację elementu stringToEscape.

Atrybuty
ObsoleteAttribute

Wyjątki

ArgumentNullException

Parametr stringToEscape ma wartość null.

UriFormatException

tylko .NET Framework: długość stringToEscape przekracza 32766 znaków.

Uwagi

EscapeUriString Użyj metody , aby przygotować ciąg identyfikatora URI niewyobrażnego jako parametr konstruktoraUri.

Domyślnie EscapeUriString metoda konwertuje wszystkie znaki, z wyjątkiem znaków zarezerwowanych RFC 2396, na ich reprezentację szesnastkową. Jeśli włączono analizowanie międzynarodowych identyfikatorów zasobów (IRI) lub międzynarodowych nazw domen (IDN), EscapeUriString metoda konwertuje wszystkie znaki, z wyjątkiem znaków zarezerwowanych RFC 3986, do ich reprezentacji szesnastkowej. Wszystkie znaki Unicode są konwertowane na format UTF-8 przed ucieczką.

W tej metodzie przyjęto założenie, że stringToEscape nie ma w niej żadnych sekwencji ucieczki.

Domyślnie ciąg jest unikany zgodnie z RFC 2396. Jeśli włączono analizowanie międzynarodowych identyfikatorów zasobów (IRI) lub międzynarodowych nazw domen (IDN), ciąg zostanie unikniony zgodnie z RFC 3986 i RFC 3987. Zapoznaj się z tymi dokumentami RFC, aby zapoznać się z definicją zastrzeżonych i nieprzestrzeżonych znaków.

Aby uzyskać więcej informacji na temat obsługi IRI, zobacz sekcję Uri Uwagi dla klasy.

Dotyczy