Uri.EscapeDataString(String) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Konwertuje ciąg na jego reprezentację ucieczki.

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

Ciąg do ucieczki.

Zwraca

String

Unikniętą reprezentacją elementu stringToEscape.

Wyjątki

ArgumentNullException

stringToEscape to null.

UriFormatException

Uwaga: na platformie .NET dla aplikacji Windows Store lub biblioteki klas przenośnych przechwyć wyjątek klasy bazowej, FormatExceptionzamiast tego.

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

Uwagi

Domyślnie EscapeDataString metoda konwertuje wszystkie znaki z wyjątkiem znaków nieprzestrzeżonych przez RFC 2396 na ich reprezentację szesnastkową. Jeśli włączono analizowanie międzynarodowych identyfikatorów zasobów (IRI) lub międzynarodowych nazw domen (IDN), EscapeDataString metoda konwertuje wszystkie znaki, z wyjątkiem znaków nieuwzruszonych RFC 3986, na ich reprezentację szesnastkowa. 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 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 usuwany zgodnie z RFC 3986 i RFC 3987. Zapoznaj się z tymi dokumentami RFC, aby uzyskać 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