Uri.EscapeDataString(String) Uri.EscapeDataString(String) Uri.EscapeDataString(String) Uri.EscapeDataString(String) Method

Definition

Konvertiert eine Zeichenfolge in eine Darstellung mit Escapezeichen.Converts a string to its escaped representation.

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

Parameter

stringToEscape
String String String String

Die Zeichenfolge, die mit Escapezeichen versehen werden soll.The string to escape.

Gibt zurück

Ein String, der die Darstellung von stringToEscape mit Escapezeichen enthält.A String that contains the escaped representation of stringToEscape.

Ausnahmen

Fangen Sie in .NET für Windows Store-Apps oder der portablen Klassenbibliothek stattdessen die Basisklassenausnahme FormatException ab.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Die Länge von stringToEscape überschreitet 32766 Zeichen.The length of stringToEscape exceeds 32766 characters.

Hinweise

In der Standardeinstellung die EscapeDataString Methode konvertiert alle Zeichen mit Ausnahme von RFC 2396 nicht reservierten Zeichen in ihrer hexadezimalen Darstellung.By default, the EscapeDataString method converts all characters except for RFC 2396 unreserved characters to their hexadecimal representation. Wenn International Resource Identifiers (IRIs) oder Parsen von Internationalized Domain Name (IDN) aktiviert ist, die EscapeDataString Methode konvertiert alle Zeichen, mit Ausnahme von RFC 3986 nicht reservierte Zeichen, die in ihrer hexadezimalen Darstellung.If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the EscapeDataString method converts all characters, except for RFC 3986 unreserved characters, to their hexadecimal representation. Alle Unicode-Zeichen werden in UTF-8-Format konvertiert, bevor Sie mit Escapezeichen versehen wird.All Unicode characters are converted to UTF-8 format before being escaped.

Diese Methode setzt voraus, dass stringToEscape verfügt über keine Escapesequenzen.This method assumes that stringToEscape has no escape sequences in it.

Standardmäßig wird die Zeichenfolge gemäß RFC 2396 mit Escapezeichen versehen.By default, the string is escaped according to RFC 2396. Wenn International Resource Identifiers (IRIs) oder Parsen von Internationalized Domain Name (IDN) aktiviert ist, wird die Zeichenfolge gemäß RFC 3986 und RFC 3987 mit Escapezeichen versehen.If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the string is escaped according to RFC 3986 and RFC 3987. Finden Sie unter folgenden RFCs für eine Definition der reservierter und nicht reservierter Zeichen.See these RFCs for a definition of reserved and unreserved characters.

Weitere Informationen zur IRI-Unterstützung finden Sie im Abschnitt "Hinweise" für die Uri Klasse.For more information on IRI support, see the Remarks section for the Uri class.

Gilt für: