Udostępnij za pośrednictwem


Uri.EscapeUriString(String) Metoda

Definicja

Przestroga

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

Przestroga

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

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.", 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

Ciąg do ucieczki.

Zwraca

Unikniętą reprezentacją elementu stringToEscape.

Atrybuty

Wyjątki

stringToEscape to null.

Długość stringToEscape przekracza 32766 znaków.

    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.

Uwagi

EscapeUriString Użyj metody , aby przygotować ciąg identyfikatora URI niewyobrażnego, aby był parametrem konstruktoraUri.

Domyślnie EscapeUriString metoda konwertuje wszystkie znaki, z wyjątkiem znaków zarezerwowanych RFC 2396, na ich reprezentację szesnastkowa. 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ą.

Ta metoda zakłada, że stringToEscape nie ma w nim żadnych sekwencji ucieczki.

Domyślnie ciąg jest ucieczki zgodnie z RFC 2396. Jeśli włączono analizowanie międzynarodowych identyfikatorów zasobów (IRI) lub międzynarodowych nazw domen (IDN), ciąg jest ucieczki zgodnie z RFC 3986 i RFC 3987. Zapoznaj się z tymi elementami RFCs, aby uzyskać definicję zastrzeżonych i nieuwzpiętnych znaków.

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

Dotyczy