System::Xml::XmlTextWriter klasse

XmlTextWriter class

Stelt een schrijver voor die een snelle, niet‑gecachede, alleen‑voorwaartse manier biedt om streams of bestanden te genereren die XML-gegevens bevatten en voldoen aan de W3C Extensible Markup Language (XML) 1.0‑specificatie en de Namespaces in XML‑aanbevelingen.

class XmlTextWriter : public System::Xml::XmlWriter

Methoden

MethodeBeschrijving
Close() overrideSluit deze stream en de onderliggende stream.
Flush() overrideLeegt alles wat in de buffer zit naar de onderliggende streams en leegt ook de onderliggende stream.
get_BaseStream()Retourneert het onderliggende stream‑object.
get_Formatting()Geeft aan hoe de uitvoer wordt opgemaakt.
get_Indentation()Retourneert hoeveel IndentChars er voor elk niveau in de hiërarchie moeten worden geschreven wanneer XmlTextWriter::set_Formatting is ingesteld op Formatting::Indented.
get_IndentChar()Retourneert welk teken moet worden gebruikt voor inspringen wanneer XmlTextWriter::set_Formatting is ingesteld op Formatting::Indented.
get_Namespaces()Retourneert een waarde die aangeeft of namespace‑ondersteuning moet worden toegepast.
get_QuoteChar()Retourneert welk teken moet worden gebruikt om attribuutwaarden te citeren.
get_WriteState() overrideRetourneert de status van de schrijver.
get_XmlLang() overrideRetourneert de huidige xml:lang‑scope.
get_XmlSpace() overrideRetourneert een XmlSpace die de huidige xml:space‑scope vertegenwoordigt.
LookupPrefix(String) overrideRetourneert het dichtstbijzijnde voorvoegsel dat is gedefinieerd in de huidige namespace‑scope voor de namespace‑URI.
set_Formatting(System::Xml::Formatting)Geeft aan hoe de uitvoer wordt opgemaakt.
set_Indentation(int32_t)Stelt in hoeveel IndentChars er voor elk niveau in de hiërarchie moeten worden geschreven wanneer XmlTextWriter::set_Formatting is ingesteld op Formatting::Indented.
set_IndentChar(char16_t)Stelt in welk teken moet worden gebruikt voor inspringen wanneer XmlTextWriter::set_Formatting is ingesteld op Formatting::Indented.
set_Namespaces(bool)Stelt een waarde in die aangeeft of namespace-ondersteuning moet worden uitgevoerd.
set_QuoteChar(char16_t)Stelt in welk teken moet worden gebruikt om attribuutwaarden te citeren.
WriteBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideEncodeert de opgegeven binaire bytes als base64 en schrijft de resulterende tekst.
WriteBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideEncodeert de opgegeven binaire bytes als binhex en schrijft de resulterende tekst.
WriteCData(String) overrideSchrijft een -blok dat de opgegeven tekst bevat.
WriteCharEntity(char16_t) overrideForceert de generatie van een tekenentiteit voor de opgegeven Unicode-tekenwaarde.
WriteChars(ArrayPtr<char16_t>, int32_t, int32_t) overrideSchrijft tekst één buffer per keer.
WriteComment(String) overrideSchrijft een commentaar **** met de opgegeven tekst.
WriteDocType(const String&, const String&, const String&, const String&) overrideSchrijft de DOCTYPE-declaratie met de opgegeven naam en optionele attributen.
WriteEndAttribute() overrideSluit de vorige XmlTextWriter::WriteStartAttribute aanroep.
WriteEndDocument() overrideSluit eventuele open elementen of attributen en zet de schrijver terug in de Start-toestand.
WriteEndElement() overrideSluit één element en verwijdert de bijbehorende namespace-scope.
WriteEntityRef(const String&) overrideSchrijft een entiteitsreferentie als &name;.
WriteFullEndElement() overrideSluit één element en verwijdert de bijbehorende namespace-scope.
WriteName(const String&) overrideSchrijft de opgegeven naam, waarbij wordt gegarandeerd dat deze een geldige naam is volgens de W3C XML 1.0 recommendation.
WriteNmToken(const String&) overrideSchrijft de opgegeven naam, waarbij wordt gegarandeerd dat deze een geldig NmToken is volgens de W3C XML 1.0 recommendation.
WriteProcessingInstruction(String, String) overrideSchrijft een verwerkingsinstructie met een spatie tussen de naam en de tekst als volgt: .
WriteQualifiedName(const String&, const String&) overrideSchrijft de namespace-gekwalificeerde naam. Deze methode zoekt het prefix op dat in scope is voor de opgegeven namespace.
WriteRaw(ArrayPtr<char16_t>, int32_t, int32_t) overrideSchrijft ruwe markup handmatig vanuit een tekenbuffer.
WriteRaw(const String&) overrideSchrijft ruwe markup handmatig vanuit een string.
WriteStartAttribute(const String&, const String&, const String&) overrideSchrijft het begin van een attribuut.
WriteStartDocument() overrideSchrijft de XML-declaratie met de versie “1.0”.
WriteStartDocument(bool) overrideSchrijft de XML-declaratie met de versie “1.0” en het standalone-attribuut.
WriteStartElement(const String&, const String&, const String&) overrideSchrijft de opgegeven starttag en koppelt deze aan de opgegeven namespace en prefix.
WriteString(const String&) overrideSchrijft de opgegeven tekstinhoud.
WriteSurrogateCharEntity(char16_t, char16_t) overrideGenereert en schrijft de surrogate-tekenentiteit voor het surrogate-tekenpaar.
WriteWhitespace(String) overrideSchrijft de opgegeven witruimte weg.
XmlTextWriter(const SharedPtr<IO::Stream>&, const SharedPtr<Text::Encoding>&)Maakt een instantie van de XmlTextWriter klasse aan met de opgegeven stream en codering.
XmlTextWriter(const String&, const SharedPtr<Text::Encoding>&)Maakt een instantie van de XmlTextWriter klasse aan met het opgegeven bestand.
XmlTextWriter(const SharedPtr<IO::TextWriter>&)Maakt een instantie van de XmlTextWriter klasse aan met de opgegeven TextWriter.

Typedefs

TypedefBeschrijving
PtrEen alias voor een gedeelde pointer naar een exemplaar van deze klasse.

Opmerkingen

Het wordt aanbevolen om in plaats daarvan de XmlWriter klasse te gebruiken.

Objecten van deze klasse mogen alleen worden gealloceerd met de functie System::MakeObject(). Maak nooit exemplaren van dit type op de stack of met operator new, omdat dit leidt tot runtime‑fouten en/of assertiefouten. Wikkel deze klasse altijd in een System::SmartPtr pointer en gebruik deze pointer om deze als argument aan functies door te geven.

Zie ook