XmlTextWriter (Clase) (System.Xml)

esta clase implementa la clase de XmlWriter .

Note
En la versión de .NET Framework 2.0 , la práctica recomendada es crear instancias de XmlWriter utilizando el método de XmlWriter.Create y la clase de XmlWriterSettings . Esto permite aproveche completo de todas las nuevas características introducidas en esta versión. Para obtener más información, vea Creating XML Writers.

XmlTextWriter mantiene una pila de espacio de nombres correspondiente a todos los espacios de nombres definidos en la pila del elemento actual. Mediante XmlTextWriter puede declarar espacios de nombres manualmente.

 w.WriteStartElement("root");
 w.WriteAttributeString("xmlns", "x", null, "urn:1");
  w.WriteStartElement("item","urn:1");
  w.WriteEndElement();
  w.WriteStartElement("item","urn:1");
  w.WriteEndElement();
 w.WriteEndElement();

El código anterior de C# genera el siguiente resultado. XmlTextWriter promueve la declaración de espacio de nombres al elemento raíz para evitar hacer duplicó en los dos elementos secundarios. Los elementos secundarios detecte el prefijo de la declaración de espacio de nombres.

 <root xmlns:x="urn:1">
  <x:item/>
  <x:item/>
 </x:root>

XmlTextWriter también le permite invalidar la declaración de espacio de nombres actual. En el siguiente ejemplo, el URI “123 " del espacio de nombres es reemplazado por “ABC” para mostrar el elemento XML <x:node xmlns:x="abc"/>.

 w.WriteStartElement("x","node","123");
 w.WriteAttributeString("xmlns","x",null,"abc");

Mediante los métodos write que toman un prefijo como un argumento que también puede especificar qué prefijo a utilizar. En el ejemplo siguiente, dos diferentes prefijos asignados al mismo URI de espacio de nombres para mostrar texto <x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>XML.

 XmlTextWriter w = new XmlTextWriter(Console.Out);
 w.WriteStartElement("x","root","urn:1");
  w.WriteStartElement("y","item","urn:1");
  w.WriteEndElement();
 w.WriteEndElement();
 w.Close();

Si hay declaraciones de espacio de nombres para que asignan diferentes prefijos al mismo URI de espacio de nombres, XmlTextWriter recorre la pila de declaraciones de espacio de nombres hacia atrás y seleccionar el más próximo.

 XmlTextWriter w = new XmlTextWriter(Console.Out);
 w.Formatting = Formatting.Indented;
 w.WriteStartElement("x","root","urn:1");
 w.WriteStartElement("y","item","urn:1");
 w.WriteAttributeString("attr","urn:1","123");
 w.WriteEndElement();
 w.WriteEndElement();
 w.Close();

En el ejemplo anterior de C#, porque la llamada de WriteAttributeString no especifica un prefijo, el programador utiliza el prefijo último insertado en la pila de espacio de nombres, y genera XML siguiente:

 <x:root xmlns:x="urn:1">
  <y:item y:attr="123" xmlns:y="urn:1" />
 </x:root>

Si los conflictos de espacio de nombres aparecen, XmlTextWriter los resuelve generando prefijos alternativos. Por ejemplo, si un atributo y un elemento tienen el mismo prefijo pero distintos espacios de nombres, XmlWriter genera un prefijo alternativo para el atributo. Los prefijos generados se denominan n{i} donde es un principio i number en 1. El número se restablece en 1 para cada elemento.

Atributos que están asociados con un URI de espacio de nombres deben tener un prefijo (los espacios de nombres predeterminados no se aplican a los atributos). esto se ajusta a la sección 5,2 de los espacios de nombres de W3C en la recomendación de XML. Si las referencias de un atributo un URI de espacio de nombres, pero no especifican un prefijo, el programador genera un prefijo para el atributo.

Al escribir un elemento vacío, un espacio adicional se agrega entre el nombre y la etiqueta de cierre, por ejemplo <item />de la etiqueta. esto proporciona compatibilidad con los exploradores más antiguos.

cuando String se utiliza como parámetro de método, null y String.Empty son equivalentes. String.Empty sigue las reglas del W3C.

para escribir datos fuertemente tipados, utilice la clase de XmlConvert para convertir tipos de datos a la cadena. Por ejemplo, el código de C# siguiente convierte los datos de Double a String y escribe el elemento <price>19.95</price>.

 Double price = 19.95;
 writer.WriteElementString("price", XmlConvert.ToString(price));

XmlTextWriter no comprueba lo siguiente:

• Caracteres no válidos en nombres de atributo y elemento.

• Caracteres Unicode que no se ajustan a la codificación especificada. Si los caracteres Unicode no se ajustan a la codificación especificada, XmlTextWriter no convierte caracteres Unicode en las entidades de caracteres.

• atributos duplicados.

• Caracteres del identificador público DOCTYPE o el identificador del sistema.

Para obtener más información sobre la escritura de XML, vea Writing XML with the XmlWriter.

Consideraciones de seguridad

.NET Framework

.NET Framework Client Profile

Windows 8 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Referencia

Otros recursos