classe System::Xml::XmlTextWriter

XmlTextWriter class

Représente un écrivain qui fournit une méthode rapide, non mise en cache, en avant uniquement pour générer des flux ou des fichiers contenant des données XML conformes à la spécification W3C Extensible Markup Language (XML) 1.0 et aux recommandations Namespaces in XML.

class XmlTextWriter : public System::Xml::XmlWriter

Méthodes

MéthodeDescription
Close() overrideFerme ce flux ainsi que le flux sous-jacent.
Flush() overrideVide tout ce qui se trouve dans le tampon vers les flux sous-jacents et vide également le flux sous-jacent.
get_BaseStream()Renvoie l’objet flux sous-jacent.
get_Formatting()Indique comment la sortie est formatée.
get_Indentation()Renvoie le nombre d’IndentChars à écrire pour chaque niveau de la hiérarchie lorsque XmlTextWriter::set_Formatting est défini sur Formatting::Indented.
get_IndentChar()Renvoie le caractère à utiliser pour l’indentation lorsque XmlTextWriter::set_Formatting est défini sur Formatting::Indented.
get_Namespaces()Renvoie une valeur indiquant s’il faut activer la prise en charge des espaces de noms.
get_QuoteChar()Renvoie le caractère à utiliser pour citer les valeurs d’attribut.
get_WriteState() overrideRenvoie l’état de l’écrivain.
get_XmlLang() overrideRenvoie la portée actuelle de xml:lang.
get_XmlSpace() overrideRenvoie un XmlSpace représentant la portée actuelle de xml:space.
LookupPrefix(String) overrideRenvoie le préfixe le plus proche défini dans la portée actuelle de l’espace de noms pour l’URI de l’espace de noms.
set_Formatting(System::Xml::Formatting)Indique comment la sortie est formatée.
set_Indentation(int32_t)Définit le nombre d’IndentChars à écrire pour chaque niveau de la hiérarchie lorsque XmlTextWriter::set_Formatting est défini sur Formatting::Indented.
set_IndentChar(char16_t)Définit le caractère à utiliser pour l’indentation lorsque XmlTextWriter::set_Formatting est défini sur Formatting::Indented.
set_Namespaces(bool)Définit une valeur indiquant s’il faut activer la prise en charge des espaces de noms.
set_QuoteChar(char16_t)Définit le caractère à utiliser pour citer les valeurs d’attribut.
WriteBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideEncode les octets binaires spécifiés en base64 et écrit le texte résultant.
WriteBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideEncode les octets binaires spécifiés en binhex et écrit le texte résultant.
WriteCData(String) overrideÉcrit un bloc contenant le texte spécifié.
WriteCharEntity(char16_t) overrideForce la génération d’une entité de caractère pour la valeur Unicode spécifiée.
WriteChars(ArrayPtr<char16_t>, int32_t, int32_t) overrideÉcrit le texte un tampon à la fois.
WriteComment(String) overrideÉcrit un commentaire **** contenant le texte spécifié.
WriteDocType(const String&, const String&, const String&, const String&) overrideÉcrit la déclaration DOCTYPE avec le nom spécifié et les attributs optionnels.
WriteEndAttribute() overrideFerme l’appel précédent à XmlTextWriter::WriteStartAttribute.
WriteEndDocument() overrideFerme tous les éléments ou attributs ouverts et remet l’écrivain à l’état Start.
WriteEndElement() overrideFerme un élément et dépile la portée d’espace de noms correspondante.
WriteEntityRef(const String&) overrideÉcrit une référence d’entité sous la forme &name;.
WriteFullEndElement() overrideFerme un élément et dépile la portée d’espace de noms correspondante.
WriteName(const String&) overrideÉcrit le nom spécifié, en s’assurant qu’il s’agit d’un nom valide selon la recommandation XML 1.0 du W3C.
WriteNmToken(const String&) overrideÉcrit le nom spécifié, en veillant à ce qu’il soit un NmToken valide selon la recommandation W3C XML 1.0.
WriteProcessingInstruction(String, String) overrideÉcrit une instruction de traitement avec un espace entre le nom et le texte comme suit : .
WriteQualifiedName(const String&, const String&) overrideÉcrit le nom qualifié par l’espace de noms. Cette méthode recherche le préfixe qui est en portée pour l’espace de noms donné.
WriteRaw(ArrayPtr<char16_t>, int32_t, int32_t) overrideÉcrit du balisage brut manuellement à partir d’un tampon de caractères.
WriteRaw(const String&) overrideÉcrit du balisage brut manuellement à partir d’une chaîne.
WriteStartAttribute(const String&, const String&, const String&) overrideÉcrit le début d’un attribut.
WriteStartDocument() overrideÉcrit la déclaration XML avec la version “1.0”.
WriteStartDocument(bool) overrideÉcrit la déclaration XML avec la version “1.0” et l’attribut standalone.
WriteStartElement(const String&, const String&, const String&) overrideÉcrit la balise d’ouverture spécifiée et l’associe à l’espace de noms et au préfixe fournis.
WriteString(const String&) overrideÉcrit le contenu texte fourni.
WriteSurrogateCharEntity(char16_t, char16_t) overrideGénère et écrit l’entité de caractère de substitution pour la paire de caractères de substitution.
WriteWhitespace(String) overrideÉcrit l’espace blanc fourni.
XmlTextWriter(const SharedPtr<IO::Stream>&, const SharedPtr<Text::Encoding>&)Crée une instance de la classe XmlTextWriter en utilisant le flux et l’encodage spécifiés.
XmlTextWriter(const String&, const SharedPtr<Text::Encoding>&)Crée une instance de la classe XmlTextWriter en utilisant le fichier spécifié.
XmlTextWriter(const SharedPtr<IO::TextWriter>&)Crée une instance de la classe XmlTextWriter en utilisant le TextWriter spécifié.

Typedefs

TypedefDescription
PtrUn alias pour un pointeur partagé vers une instance de cette classe.

Remarques

Il est recommandé d’utiliser la classe XmlWriter à la place.

Les objets de cette classe ne doivent être alloués qu’en utilisant la fonction System::MakeObject(). Ne créez jamais d’instances de ce type sur la pile ou en utilisant l’opérateur new, car cela entraînera des erreurs d’exécution et/ou des échecs d’assertion. Enveloppez toujours cette classe dans un pointeur System::SmartPtr et utilisez ce pointeur pour le passer aux fonctions en tant qu’argument.

Voir aussi