classe System::Xml::XmlTextWriter

XmlTextWriter class

Rappresenta uno scrittore che fornisce un modo rapido, non memorizzato nella cache e solo in avanti per generare flussi o file contenenti dati XML conformi al W3C Extensible Markup Language (XML) 1.0 e alle raccomandazioni Namespaces in XML.

class XmlTextWriter : public System::Xml::XmlWriter

Metodi

MetodoDescrizione
Close() overrideChiude questo flusso e il flusso sottostante.
Flush() overrideSvuota tutto ciò che è nel buffer verso i flussi sottostanti e svuota anche il flusso sottostante.
get_BaseStream()Restituisce l’oggetto flusso sottostante.
get_Formatting()Indica come è formattato l’output.
get_Indentation()Restituisce quanti IndentChars scrivere per ogni livello nella gerarchia quando XmlTextWriter::set_Formatting è impostato su Formatting::Indented.
get_IndentChar()Restituisce quale carattere utilizzare per l’indentazione quando XmlTextWriter::set_Formatting è impostato su Formatting::Indented.
get_Namespaces()Restituisce un valore che indica se abilitare il supporto dei namespace.
get_QuoteChar()Restituisce quale carattere utilizzare per citare i valori degli attributi.
get_WriteState() overrideRestituisce lo stato del writer.
get_XmlLang() overrideRestituisce l’ambito xml:lang corrente.
get_XmlSpace() overrideRestituisce un XmlSpace che rappresenta l’ambito xml:space corrente.
LookupPrefix(String) overrideRestituisce il prefisso più vicino definito nell’ambito namespace corrente per l’URI del namespace.
set_Formatting(System::Xml::Formatting)Indica come è formattato l’output.
set_Indentation(int32_t)Imposta quanti IndentChars scrivere per ogni livello nella gerarchia quando XmlTextWriter::set_Formatting è impostato su Formatting::Indented.
set_IndentChar(char16_t)Imposta quale carattere utilizzare per l’indentazione quando XmlTextWriter::set_Formatting è impostato su Formatting::Indented.
set_Namespaces(bool)Imposta un valore che indica se abilitare il supporto dei namespace.
set_QuoteChar(char16_t)Imposta quale carattere utilizzare per citare i valori degli attributi.
WriteBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideCodifica i byte binari specificati come base64 e scrive il testo risultante.
WriteBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideCodifica i byte binari specificati come binhex e scrive il testo risultante.
WriteCData(String) overrideScrive un blocco contenente il testo specificato.
WriteCharEntity(char16_t) overrideForza la generazione di un’entità di carattere per il valore Unicode del carattere specificato.
WriteChars(ArrayPtr<char16_t>, int32_t, int32_t) overrideScrive il testo un buffer alla volta.
WriteComment(String) overrideScrive un commento **** contenente il testo specificato.
WriteDocType(const String&, const String&, const String&, const String&) overrideScrive la dichiarazione DOCTYPE con il nome specificato e gli attributi opzionali.
WriteEndAttribute() overrideChiude la chiamata precedente a XmlTextWriter::WriteStartAttribute.
WriteEndDocument() overrideChiude eventuali elementi o attributi aperti e riporta il writer allo stato Start.
WriteEndElement() overrideChiude un elemento e rimuove l’ambito namespace corrispondente.
WriteEntityRef(const String&) overrideScrive un riferimento a entità come &name;.
WriteFullEndElement() overrideChiude un elemento e rimuove l’ambito namespace corrispondente.
WriteName(const String&) overrideScrive il nome specificato, assicurandosi che sia un nome valido secondo la W3C XML 1.0 recommendation.
WriteNmToken(const String&) overrideScrive il nome specificato, assicurandosi che sia un NmToken valido secondo la raccomandazione W3C XML 1.0.
WriteProcessingInstruction(String, String) overrideScrive un’istruzione di elaborazione con uno spazio tra il nome e il testo come segue: .
WriteQualifiedName(const String&, const String&) overrideScrive il nome qualificato per lo spazio dei nomi. Questo metodo ricerca il prefisso che è in ambito per lo spazio dei nomi fornito.
WriteRaw(ArrayPtr<char16_t>, int32_t, int32_t) overrideScrive markup grezzo manualmente da un buffer di caratteri.
WriteRaw(const String&) overrideScrive markup grezzo manualmente da una stringa.
WriteStartAttribute(const String&, const String&, const String&) overrideScrive l’inizio di un attributo.
WriteStartDocument() overrideScrive la dichiarazione XML con la versione “1.0”.
WriteStartDocument(bool) overrideScrive la dichiarazione XML con la versione “1.0” e l’attributo standalone.
WriteStartElement(const String&, const String&, const String&) overrideScrive il tag di apertura specificato e lo associa allo spazio dei nomi e al prefisso forniti.
WriteString(const String&) overrideScrive il contenuto di testo fornito.
WriteSurrogateCharEntity(char16_t, char16_t) overrideGenera e scrive l’entità di carattere surrogato per la coppia di caratteri surrogati.
WriteWhitespace(String) overrideScrive lo spazio bianco fornito.
XmlTextWriter(const SharedPtr<IO::Stream>&, const SharedPtr<Text::Encoding>&)Crea un’istanza della classe XmlTextWriter utilizzando lo stream e la codifica specificati.
XmlTextWriter(const String&, const SharedPtr<Text::Encoding>&)Crea un’istanza della classe XmlTextWriter utilizzando il file specificato.
XmlTextWriter(const SharedPtr<IO::TextWriter>&)Crea un’istanza della classe XmlTextWriter utilizzando il TextWriter specificato.

Typedefs

TypedefDescrizione
PtrUn alias per un puntatore condiviso a un’istanza di questa classe.

Osservazioni

Si consiglia di utilizzare la classe XmlWriter al suo posto.

Gli oggetti di questa classe devono essere allocati solo usando la funzione System::MakeObject(). Non creare mai istanze di questo tipo sullo stack o usando l’operatore new, poiché ciò provocherà errori di runtime e/o fallimenti di asserzione. Avvolgi sempre questa classe in un puntatore System::SmartPtr e usa questo puntatore per passarlo alle funzioni come argomento.

Vedi anche