System.JSON.Utils.TJsonTextUtils.WriteEscapedString

• Übergeordnet: TJsonTextUtils

Delphi

class procedure WriteEscapedString(const Writer: TTextWriter; const Str: string; Delimiter: Char;  AppendDelimiters: Boolean; const CharEscapeFlags: array of Boolean; StringEscapeHandling: TJsonStringEscapeHandling; var WriteBuffer: TCharArray);

C++

__classmethod void __fastcall WriteEscapedString(System::Classes::TTextWriter* const Writer, const System::UnicodeString Str, System::WideChar Delimiter, bool AppendDelimiters, const bool *CharEscapeFlags, const int CharEscapeFlags_High, System::Json::Types::TJsonStringEscapeHandling StringEscapeHandling, System::DynamicArray<System::WideChar> &WriteBuffer);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	public	System.JSON.Utils.pas System.JSON.Utils.hpp	System.JSON.Utils	TJsonTextUtils

Beschreibung

Generiert einen JSON-String aus einem gegebenen String.

WriteEscapedString übernimmt die folgenden Parameter:

• Writer ist der Text-Writer, mit dem WriteEscapedString den resultierenden JSON-String generiert.
• Str ist der String, der in einen JSON-String konvertiert werden soll.
• AppendDelimiters legt fest, ob der resultierende String in Anführungszeichen eingeschlossen werden soll (True) oder nicht (False).
• Delimiter ist das Anführungszeichen, das am Anfang und am Ende des resultierenden JSON-String hinzugefügt werden soll, wenn AppendDelimiters True ist. Damit der resultierende JSON-String korrekt ist, muss dieses Zeichen entweder ein einzelnes Anführungszeichen (') oder ein Anführungszeichen (") sein.
• CharEscapeFlags ist ein Array mit Flags zum Einschließen von Zeichen in Escape-Zeichen. Weitere Informationen finden Sie unter Einschließen von Zeichen in Escape-Zeichen weiter unten.
• StringEscapeHandling legt den Typ des Zeichens zum Einschließen von Zeichen in Escape-Zeichen fest, den WriteEscapedString verwendet.
• WriteBuffer ist ein Puffer, der intern von WriteEscapedString verwendet wird.

Einschließen von Zeichen in Escape-Zeichen

WriteEscapedString schließt folgende Zeichen in Escape-Zeichen ein:

• Zeichen, die in CharEscapeFlags ein True-Flag enthalten.
• Zeichen, in CharEscapeFlags kein entsprechendes Flag enthalten, wenn StringEscapeHandling TJsonStringEscapeHandling.EscapeNonAscii ist.

WriteEscapedString schließt die meisten Zeichen mittels Unicode-Escape-Sequenzen in Escape-Zeichen ein. Die folgende Tabelle enthält die Zeichen, die WriteEscapedString auf andere Weise in Escape-Zeichen einschließt:

Zeichen	Zeichen mit Escape-Zeichen
Tabulator	\t
Neue Zeile	\n
Wagenrücklauf	\r
Seitenvorschub	\f
Rück	\b
Backslash	\\
Anführungszeichen*	\"
Einzelnes Anführungszeichen*	\'

* Wenn StringEscapeHandling TJsonStringEscapeHandling.EscapeHtml ist, schließt WriteEscapedString einzelne Anführungszeichen und Anführungszeichen mittels Unicode-Escape-Sequenzen in Escape-Zeichen ein.

Siehe auch

• System.JSON.Utils.TJsonTextUtils.ShouldEscapeJavaScriptString
• System.JSON.Utils.TJsonTextUtils.ToCharAsUnicode