Clase System::Xml::XmlTextWriter

XmlTextWriter class

Representa un escritor que proporciona una forma rápida, sin caché y solo de avance para generar flujos o archivos que contienen datos XML que cumplen con el Extensible Markup Language (XML) 1.0 del W3C y las recomendaciones de Namespaces in XML.

class XmlTextWriter : public System::Xml::XmlWriter

Métodos

MétodoDescripción
Close() overrideCierra este flujo y el flujo subyacente.
Flush() overrideVuelca lo que haya en el búfer a los flujos subyacentes y también vacía el flujo subyacente.
get_BaseStream()Devuelve el objeto de flujo subyacente.
get_Formatting()Indica cómo se formatea la salida.
get_Indentation()Devuelve cuántos IndentChars escribir para cada nivel en la jerarquía cuando XmlTextWriter::set_Formatting está configurado a Formatting::Indented.
get_IndentChar()Devuelve qué carácter usar para la sangría cuando XmlTextWriter::set_Formatting está configurado a Formatting::Indented.
get_Namespaces()Devuelve un valor que indica si se debe habilitar el soporte de espacios de nombres.
get_QuoteChar()Devuelve qué carácter usar para citar los valores de los atributos.
get_WriteState() overrideDevuelve el estado del escritor.
get_XmlLang() overrideDevuelve el alcance actual de xml:lang.
get_XmlSpace() overrideDevuelve un XmlSpace que representa el alcance actual de xml:space.
LookupPrefix(String) overrideDevuelve el prefijo más cercano definido en el alcance de espacio de nombres actual para el URI del espacio de nombres.
set_Formatting(System::Xml::Formatting)Indica cómo se formatea la salida.
set_Indentation(int32_t)Establece cuántos IndentChars escribir para cada nivel en la jerarquía cuando XmlTextWriter::set_Formatting está configurado a Formatting::Indented.
set_IndentChar(char16_t)Establece qué carácter usar para la sangría cuando XmlTextWriter::set_Formatting está configurado a Formatting::Indented.
set_Namespaces(bool)Establece un valor que indica si se debe habilitar el soporte de espacios de nombres.
set_QuoteChar(char16_t)Establece qué carácter usar para citar los valores de los atributos.
WriteBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideCodifica los bytes binarios especificados como base64 y escribe el texto resultante.
WriteBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideCodifica los bytes binarios especificados como binhex y escribe el texto resultante.
WriteCData(String) overrideEscribe un bloque que contiene el texto especificado.
WriteCharEntity(char16_t) overrideForza la generación de una entidad de carácter para el valor de carácter Unicode especificado.
WriteChars(ArrayPtr<char16_t>, int32_t, int32_t) overrideEscribe texto un búfer a la vez.
WriteComment(String) overrideEscribe un comentario **** que contiene el texto especificado.
WriteDocType(const String&, const String&, const String&, const String&) overrideEscribe la declaración DOCTYPE con el nombre especificado y atributos opcionales.
WriteEndAttribute() overrideCierra la llamada anterior a XmlTextWriter::WriteStartAttribute.
WriteEndDocument() overrideCierra cualquier elemento o atributo abierto y devuelve el escritor al estado Start.
WriteEndElement() overrideCierra un elemento y elimina el ámbito de espacio de nombres correspondiente.
WriteEntityRef(const String&) overrideEscribe una referencia de entidad como &name;.
WriteFullEndElement() overrideCierra un elemento y elimina el ámbito de espacio de nombres correspondiente.
WriteName(const String&) overrideEscribe el nombre especificado, asegurándose de que sea un nombre válido según la recomendación W3C XML 1.0.
WriteNmToken(const String&) overrideEscribe el nombre especificado, asegurándose de que sea un NmToken válido según la recomendación W3C XML 1.0.
WriteProcessingInstruction(String, String) overrideEscribe una instrucción de procesamiento con un espacio entre el nombre y el texto de la siguiente manera: .
WriteQualifiedName(const String&, const String&) overrideEscribe el nombre calificado con espacio de nombres. Este método busca el prefijo que está en alcance para el espacio de nombres dado.
WriteRaw(ArrayPtr<char16_t>, int32_t, int32_t) overrideEscribe marcado sin procesar manualmente desde un búfer de caracteres.
WriteRaw(const String&) overrideEscribe marcado sin procesar manualmente desde una cadena.
WriteStartAttribute(const String&, const String&, const String&) overrideEscribe el inicio de un atributo.
WriteStartDocument() overrideEscribe la declaración XML con la versión “1.0”.
WriteStartDocument(bool) overrideEscribe la declaración XML con la versión “1.0” y el atributo standalone.
WriteStartElement(const String&, const String&, const String&) overrideEscribe la etiqueta de inicio especificada y la asocia con el espacio de nombres y prefijo dados.
WriteString(const String&) overrideEscribe el contenido de texto proporcionado.
WriteSurrogateCharEntity(char16_t, char16_t) overrideGenera y escribe la entidad de carácter sustituto para el par de caracteres sustitutos.
WriteWhitespace(String) overrideEscribe el espacio en blanco dado.
XmlTextWriter(const SharedPtr<IO::Stream>&, const SharedPtr<Text::Encoding>&)Crea una instancia de la clase XmlTextWriter usando el flujo y la codificación especificados.
XmlTextWriter(const String&, const SharedPtr<Text::Encoding>&)Crea una instancia de la clase XmlTextWriter usando el archivo especificado.
XmlTextWriter(const SharedPtr<IO::TextWriter>&)Crea una instancia de la clase XmlTextWriter usando el TextWriter especificado.

Typedefs

TypedefDescripción
PtrUn alias para un puntero compartido a una instancia de esta clase.

Observaciones

Se recomienda usar la clase XmlWriter en su lugar.

Los objetos de esta clase solo deben asignarse usando la función System::MakeObject(). Nunca cree instancias de este tipo en la pila ni usando el operador new, ya que provocará errores en tiempo de ejecución y/o fallos de aserción. Siempre envuelva esta clase en un puntero System::SmartPtr y use ese puntero para pasarlo a funciones como argumento.

Ver también