Uri.EscapeDataString Methode

Definition

Überlädt

EscapeDataString(ReadOnlySpan<Char>)
EscapeDataString(String)

Konvertiert eine Zeichenfolge in eine Darstellung mit Escapezeichen.

EscapeDataString(ReadOnlySpan<Char>)

public:
 static System::String ^ EscapeDataString(ReadOnlySpan<char> charsToEscape);
public static string EscapeDataString (ReadOnlySpan<char> charsToEscape);
static member EscapeDataString : ReadOnlySpan<char> -> string
Public Shared Function EscapeDataString (charsToEscape As ReadOnlySpan(Of Char)) As String

Parameter

charsToEscape
ReadOnlySpan<Char>

Gibt zurück

Gilt für:

EscapeDataString(String)

Konvertiert eine Zeichenfolge in eine Darstellung mit Escapezeichen.

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

Die Zeichenfolge, die mit Escapezeichen versehen werden soll.

Gibt zurück

Die Darstellung von stringToEscape mit Escapezeichen.

Ausnahmen

stringToEscape ist null.

Hinweis: Fangen Sie in .NET für Windows Store-Apps oder der Portablen Klassenbibliothek stattdessen die Basisklassenausnahme FormatException ab.

Die Länge von stringToEscape überschreitet 32766 Zeichen.

Hinweise

Standardmäßig konvertiert die EscapeDataString -Methode alle Zeichen mit Ausnahme von nicht reservierten RFC 2396-Zeichen in ihre hexadezimale Darstellung. Wenn die Analyse von internationalen Ressourcenbezeichnern (IRIs) oder internationalisierten Domänennamen (Internationalized Domain Name, IDN) aktiviert ist, konvertiert die EscapeDataString Methode alle Zeichen mit Ausnahme von nicht reservierten RFC 3986-Zeichen in ihre hexadezimale Darstellung. Alle Unicode-Zeichen werden vor dem Escapezeichen in das UTF-8-Format konvertiert.

Bei dieser Methode wird davon ausgegangen, dass stringToEscape keine Escapesequenzen enthalten sind.

Standardmäßig wird die Zeichenfolge gemäß RFC 2396 mit Escapezeichen versehen. Wenn die Analyse internationaler Ressourcenbezeichner (IrIs) oder internationalisierter Domänennamen (Internationalized Domain Name, IDN) aktiviert ist, wird die Zeichenfolge gemäß RFC 3986 und RFC 3987 mit Escapezeichen versehen. Eine Definition von reservierten und nicht reservierten Zeichen finden Sie in diesen RFCs.

Weitere Informationen zur IRI-Unterstützung finden Sie im Abschnitt Hinweise für die Uri Klasse.

Gilt für: