XmlTextWriter (Clase) (System.Xml)

Esta clase implementa la clase XmlWriter.

Nota:
En la versión Microsoft .NET Framework versión 2.0, se recomienda crear instancias de XmlWriter mediante el método System.Xml.XmlWriter.Create y la clase XmlWriterSettings. De esta forma, puede aprovechar al máximo todas las nuevas funciones presentadas en esta versión. Para obtener más información, vea Creación de sistemas de escritura XML.

XmlTextWriter mantiene una pila de espacios de nombres correspondiente a todos los espacios de nombres definidos en la pila de elementos actual. Mediante XmlTextWriter se pueden declarar manualmente los espacios de nombres.

 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 C# anterior produce el resultado siguiente. XmlTextWriter promociona la declaración de espacio de nombres al elemento raíz para evitar que esté duplicada en los dos elementos secundarios. Los elementos secundarios toman el prefijo de la declaración de espacio de nombres.

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

XmlTextWriter también permite reemplazar la declaración de espacio de nombres actual. En el ejemplo siguiente, el identificador URI de espacio de nombres "123" se reemplaza por "abc" para generar el elemento XML <x:node xmlns:x="abc"/>.

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

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

 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 varias declaraciones de espacio de nombres que asignan diferentes prefijos al mismo identificador URI de espacio de nombres, XmlTextWriter recorre hacia atrás la pila de declaraciones de espacio de nombres y toma el prefijo 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 anterior ejemplo de C#, como la llamada a WriteAttributeString no especifica ningún prefijo, el sistema de escritura utiliza el último prefijo insertado en la pila de espacio de nombres y genera el siguiente fragmento de XML:

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

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

Los atributos asociados a un identificador URI de espacio de nombres deben tener un prefijo (los espacios de nombres predeterminados no son aplicables a los atributos). Esto satisface la sección 5.2 de la recomendación relativa a espacios de nombres en XML del Consorcio W3C. Si un atributo hace referencia a un identificador URI de espacio de nombres pero no especifica un prefijo, el sistema de escritura genera un prefijo para el atributo.

Cuando se escribe un elemento vacío, se agrega un espacio adicional entre el nombre de la etiqueta y la etiqueta de cierre; por ejemplo, <item />. De este modo, se garantiza la compatibilidad con exploradores más antiguos.

Cuando se utiliza String como parámetro de método, referencia null (Nothing en Visual Basic) y String.Empty son equivalentes. String.Empty sigue las reglas del consorcio W3C.

Para escribir datos con establecimiento inflexible de tipos, utilice la clase XmlConvert para convertir los tipos de datos en una cadena. Por ejemplo, el siguiente código C# convierte los datos de Double en String y escribe el elemento <price>19.95</price>.

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

XmlTextWriter no comprueba la conformidad de:

• Caracteres no válidos en los nombres de atributos y elementos.

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

• Atributos duplicados.

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

Para obtener más información sobre cómo escribir XML, vea Escribir XML con XmlWriter.

Consideraciones de seguridad

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

.NET Compact Framework

XNA Framework