System::Xml::XmlTextWriter Klasse

XmlTextWriter class

Stellt einen Writer dar, der eine schnelle, nicht zwischengespeicherte, nur vorwärts gerichtete Methode zum Erzeugen von Streams oder Dateien bietet, die XML-Daten enthalten und den W3C Extensible Markup Language (XML) 1.0- und den Namespaces in XML-Empfehlungen entsprechen.

class XmlTextWriter : public System::Xml::XmlWriter

Methoden

MethodeBeschreibung
Close() overrideSchließt diesen Stream und den zugrunde liegenden Stream.
Flush() overrideSpült alles, was im Puffer ist, in die zugrunde liegenden Streams und spült ebenfalls den zugrunde liegenden Stream.
get_BaseStream()Gibt das zugrunde liegende Stream‑Objekt zurück.
get_Formatting()Gibt an, wie die Ausgabe formatiert ist.
get_Indentation()Gibt zurück, wie viele IndentChars für jede Ebene in der Hierarchie geschrieben werden, wenn XmlTextWriter::set_Formatting auf Formatting::Indented gesetzt ist.
get_IndentChar()Gibt zurück, welches Zeichen für die Einrückung verwendet werden soll, wenn XmlTextWriter::set_Formatting auf Formatting::Indented gesetzt ist.
get_Namespaces()Gibt einen Wert zurück, der angibt, ob Namespace-Unterstützung verwendet werden soll.
get_QuoteChar()Gibt zurück, welches Zeichen zum Zitieren von Attributwerten verwendet werden soll.
get_WriteState() overrideGibt den Zustand des Writers zurück.
get_XmlLang() overrideGibt den aktuellen xml:lang-Bereich zurück.
get_XmlSpace() overrideGibt ein XmlSpace zurück, das den aktuellen xml:space-Bereich darstellt.
LookupPrefix(String) overrideGibt das nächstgelegene Präfix zurück, das im aktuellen Namespace-Bereich für die Namespace-URI definiert ist.
set_Formatting(System::Xml::Formatting)Gibt an, wie die Ausgabe formatiert ist.
set_Indentation(int32_t)Legt fest, wie viele IndentChars für jede Ebene in der Hierarchie geschrieben werden, wenn XmlTextWriter::set_Formatting auf Formatting::Indented gesetzt ist.
set_IndentChar(char16_t)Legt fest, welches Zeichen für die Einrückung verwendet werden soll, wenn XmlTextWriter::set_Formatting auf Formatting::Indented gesetzt ist.
set_Namespaces(bool)Legt einen Wert fest, der angibt, ob Namespace-Unterstützung verwendet werden soll.
set_QuoteChar(char16_t)Legt fest, welches Zeichen zum Zitieren von Attributwerten verwendet werden soll.
WriteBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideKodiert die angegebenen Binärbytes als Base64 und schreibt den resultierenden Text.
WriteBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideKodiert die angegebenen Binärbytes als BinHex und schreibt den resultierenden Text.
WriteCData(String) overrideSchreibt einen -Block, der den angegebenen Text enthält.
WriteCharEntity(char16_t) overrideErzwingt die Erzeugung einer Zeichenentität für den angegebenen Unicode-Zeichenwert.
WriteChars(ArrayPtr<char16_t>, int32_t, int32_t) overrideSchreibt Text jeweils einen Puffer nach dem anderen.
WriteComment(String) overrideSchreibt einen Kommentar ****, der den angegebenen Text enthält.
WriteDocType(const String&, const String&, const String&, const String&) overrideSchreibt die DOCTYPE-Deklaration mit dem angegebenen Namen und optionalen Attributen.
WriteEndAttribute() overrideSchließt den vorherigen Aufruf von XmlTextWriter::WriteStartAttribute.
WriteEndDocument() overrideSchließt alle offenen Elemente oder Attribute und versetzt den Writer zurück in den Startzustand.
WriteEndElement() overrideSchließt ein Element und entfernt den entsprechenden Namespace-Bereich.
WriteEntityRef(const String&) overrideSchreibt eine Entity-Referenz als &name;.
WriteFullEndElement() overrideSchließt ein Element und entfernt den entsprechenden Namespace-Bereich.
WriteName(const String&) overrideSchreibt den angegebenen Namen und stellt sicher, dass er ein gültiger Name gemäß der W3C XML 1.0 recommendation ist.
WriteNmToken(const String&) overrideSchreibt den angegebenen Namen und stellt sicher, dass er ein gültiges NmToken gemäß der W3C XML 1.0-Empfehlung ist.
WriteProcessingInstruction(String, String) overrideSchreibt eine Verarbeitungsanweisung mit einem Leerzeichen zwischen Name und Text wie folgt: .
WriteQualifiedName(const String&, const String&) overrideSchreibt den namespace-qualifizierten Namen. Diese Methode sucht das im Geltungsbereich des angegebenen Namespace befindliche Präfix.
WriteRaw(ArrayPtr<char16_t>, int32_t, int32_t) overrideSchreibt rohes Markup manuell aus einem Zeichenpuffer.
WriteRaw(const String&) overrideSchreibt rohes Markup manuell aus einem String.
WriteStartAttribute(const String&, const String&, const String&) overrideSchreibt den Beginn eines Attributs.
WriteStartDocument() overrideSchreibt die XML-Deklaration mit der Version “1.0”.
WriteStartDocument(bool) overrideSchreibt die XML-Deklaration mit der Version “1.0” und dem Standalone-Attribut.
WriteStartElement(const String&, const String&, const String&) overrideSchreibt das angegebene Start-Tag und verknüpft es mit dem angegebenen Namespace und Präfix.
WriteString(const String&) overrideSchreibt den angegebenen Textinhalt.
WriteSurrogateCharEntity(char16_t, char16_t) overrideErzeugt und schreibt die Surrogat-Zeichenentität für das Surrogat-Zeichenpaar.
WriteWhitespace(String) overrideSchreibt das angegebene Leerzeichen.
XmlTextWriter(const SharedPtr<IO::Stream>&, const SharedPtr<Text::Encoding>&)Erstellt eine Instanz der Klasse XmlTextWriter mit dem angegebenen Stream und der angegebenen Kodierung.
XmlTextWriter(const String&, const SharedPtr<Text::Encoding>&)Erstellt eine Instanz der Klasse XmlTextWriter mit der angegebenen Datei.
XmlTextWriter(const SharedPtr<IO::TextWriter>&)Erstellt eine Instanz der Klasse XmlTextWriter mit dem angegebenen TextWriter.

Typedefs

Typedef.Beschreibung
PtrEin Alias für einen Shared‑Pointer auf eine Instanz dieser Klasse.

Hinweise

Es wird empfohlen, stattdessen die Klasse XmlWriter zu verwenden.

Objekte dieser Klasse sollten nur mit der Funktion System::MakeObject() alloziert werden. Erstellen Sie niemals Instanzen dieses Typs auf dem Stack oder mit dem Operator new, da dies zu Laufzeitfehlern und/oder Assertion‑Fehlern führt. Wickeln Sie diese Klasse immer in einen System::SmartPtr‑Pointer und verwenden Sie diesen Pointer, um ihn als Argument an Funktionen zu übergeben.

Siehe auch