System::Xml::XmlWriterSettings class

XmlWriterSettings class

Specifica un insieme di funzionalità da supportare sull’oggetto XmlWriter creato dal metodo XmlWriter::Create.

class XmlWriterSettings : public System::Object

Metodi

MetodoDescrizione
Clone()Crea una copia dell’istanza XmlWriterSettings.
get_CheckCharacters()Restituisce un valore che indica se lo scrittore XML deve verificare che tutti i caratteri nel documento siano conformi alla sezione “2.2 Characters” della XML 1.0 Recommendation del W3C.
get_CloseOutput()Restituisce un valore che indica se il XmlWriter deve anche chiudere lo stream o TextWriter sottostante quando viene chiamato il metodo XmlWriter::Close.
get_ConformanceLevel()Restituisce il livello di conformità per cui lo scrittore XML verifica l’output XML.
get_DoNotEscapeUriAttributes()Restituisce un valore che indica se il XmlWriter non esegue l’escape degli attributi URI.
get_Encoding()Restituisce il tipo di codifica del testo da utilizzare.
get_Indent()Restituisce un valore che indica se indentare gli elementi.
get_IndentChars()Restituisce la stringa di caratteri da utilizzare durante l’indentazione. Questa impostazione è usata quando il valore XmlWriterSettings::set_Indent è impostato su true.
get_NamespaceHandling()Restituisce un valore che indica se il XmlWriter deve rimuovere le dichiarazioni di namespace duplicate durante la scrittura del contenuto XML. Il comportamento predefinito è che lo scrittore emetta tutte le dichiarazioni di namespace presenti nel risolutore di namespace dello scrittore.
get_NewLineChars()Restituisce la stringa di caratteri da utilizzare per le interruzioni di riga.
get_NewLineHandling()Restituisce un valore che indica se normalizzare le interruzioni di riga nell’output.
get_NewLineOnAttributes()Restituisce un valore che indica se scrivere gli attributi su una nuova riga.
get_OmitXmlDeclaration()Restituisce un valore che indica se omettere una dichiarazione XML.
get_OutputMethod()Restituisce il metodo utilizzato per serializzare l’output di XmlWriter.
get_WriteEndDocumentOnClose()Restituisce un valore che indica se XmlWriter aggiungerà i tag di chiusura a tutti i tag di elemento non chiusi quando viene chiamato il metodo XmlWriter::Close.
Reset()Ripristina i membri della classe delle impostazioni ai loro valori predefiniti.
set_CheckCharacters(bool)Imposta un valore che indica se lo scrittore XML deve verificare che tutti i caratteri nel documento siano conformi alla sezione “2.2 Characters” della Raccomandazione XML 1.0 del W3C.
set_CloseOutput(bool)Imposta un valore che indica se XmlWriter deve anche chiudere lo stream sottostante o il TextWriter quando viene chiamato il metodo XmlWriter::Close.
set_ConformanceLevel(System::Xml::ConformanceLevel)Imposta il livello di conformità per cui lo scrittore XML verifica l’output XML.
set_DoNotEscapeUriAttributes(bool)Imposta un valore che indica se XmlWriter non esegue l’escape degli attributi URI.
set_Encoding(const SharedPtr<System::Text::Encoding>&)Imposta il tipo di codifica del testo da utilizzare.
set_Indent(bool)Imposta un valore che indica se indentare gli elementi.
set_IndentChars(const String&)Imposta la stringa di caratteri da utilizzare durante l’indentazione. Questa impostazione è usata quando il valore XmlWriterSettings::set_Indent è impostato su true.
set_NamespaceHandling(System::Xml::NamespaceHandling)Imposta un valore che indica se XmlWriter deve rimuovere le dichiarazioni di namespace duplicate durante la scrittura del contenuto XML. Il comportamento predefinito è che lo scrittore emetta tutte le dichiarazioni di namespace presenti nel risolutore di namespace dello scrittore.
set_NewLineChars(const String&)Imposta la stringa di caratteri da utilizzare per le interruzioni di riga.
set_NewLineHandling(System::Xml::NewLineHandling)Imposta un valore che indica se normalizzare le interruzioni di riga nell’output.
set_NewLineOnAttributes(bool)Imposta un valore che indica se scrivere gli attributi su una nuova riga.
set_OmitXmlDeclaration(bool)Imposta un valore che indica se omettere una dichiarazione XML.
set_WriteEndDocumentOnClose(bool)Imposta un valore che indica se XmlWriter aggiungerà i tag di chiusura a tutti i tag di elemento non chiusi quando viene chiamato il metodo XmlWriter::Close.
XmlWriterSettings()Inizializza una nuova istanza della classe XmlWriterSettings.

Typedefs

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

Osservazioni

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