XmlWriter.WriteElementString Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Escribe un elemento que contiene un valor de cadena.

Sobrecargas

WriteElementString(String, String)	Escribe un elemento con el nombre local y el valor especificados.
WriteElementString(String, String, String)	Escribe un elemento con el nombre local especificado, el URI de espacio de nombres y el valor.
WriteElementString(String, String, String, String)	Escribe un elemento con el prefijo, nombre local, el URI de espacio de nombres y el valor especificados.

Comentarios

Para obtener la versión asincrónica de este método, vea WriteElementStringAsync.

WriteElementString(String, String)

Source:

XmlWriter.cs

Escribe un elemento con el nombre local y el valor especificados.

C#

public void WriteElementString (string localName, string? value);

Parámetros

localName

String

Nombre local del elemento.

value

String

Valor del elemento.

Excepciones

ArgumentException

El valor localName es null o una cadena vacía.

o bien

Los valores de parámetro no son válidos.

EncoderFallbackException

Hay un carácter en el búfer que es un carácter XML válido pero que no es válido para la codificación de salida. Por ejemplo, si la codificación de salida es ASCII, sólo debería utilizar los caracteres del intervalo de 0 a 127 para el elemento y nombres de atributo. El carácter no válido podría estar en el argumento de este método o en un argumento de métodos anteriores que estaban escribiendo en el búfer. Las referencias a entidades de caracteres anulan a dichos caracteres siempre que sea posible (por ejemplo, en nodos de texto o valores de atributo). Sin embargo, la referencia de entidad de carácter no se permite en nombres de elemento y de atributo, comentarios, instrucciones de procesamiento o secciones CDATA.

InvalidOperationException

Se llamó un método XmlWriter antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Ejemplos

En el ejemplo siguiente se usan varios métodos de escritura para crear un fragmento XML.

C#

using System;
using System.IO;
using System.Xml;

 public class Sample
 {
   private const string m_Document = "sampledata.xml";

   public static void Main() {

      XmlWriter writer = null;

      try {

        XmlWriterSettings settings = new XmlWriterSettings();
        settings.Indent = true;
        writer = XmlWriter.Create (m_Document, settings);

        writer.WriteComment("sample XML fragment");

        // Write an element (this one is the root).
        writer.WriteStartElement("book");

        // Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk", null, "urn:samples");

        // Write the genre attribute.
        writer.WriteAttributeString("genre", "novel");

        // Write the title.
        writer.WriteStartElement("title");
        writer.WriteString("The Handmaid's Tale");
        writer.WriteEndElement();

        // Write the price.
        writer.WriteElementString("price", "19.95");

        // Lookup the prefix and write the ISBN element.
        string prefix = writer.LookupPrefix("urn:samples");
        writer.WriteStartElement(prefix, "ISBN", "urn:samples");
        writer.WriteString("1-861003-78");
        writer.WriteEndElement();

        // Write the style element (shows a different way to handle prefixes).
        writer.WriteElementString("style", "urn:samples", "hardcover");

        // Write the close tag for the root element.
        writer.WriteEndElement();

        // Write the XML to file and close the writer.
        writer.Flush();
        writer.Close();
      }

      finally {
        if (writer != null)
           writer.Close();
     }
   }
 }

Comentarios

Para obtener la versión asincrónica de este método, vea WriteElementStringAsync.

WriteElementString(String, String, String)

Source:

XmlWriter.cs

Escribe un elemento con el nombre local especificado, el URI de espacio de nombres y el valor.

C#

public void WriteElementString (string localName, string? ns, string? value);

Parámetros

localName

String

Nombre local del elemento.

ns

String

Identificador URI de espacio de nombres que se va a asociar al elemento.

value

String

Valor del elemento.

Excepciones

ArgumentException

El valor localName es null o una cadena vacía.

o bien

Los valores de parámetro no son válidos.

EncoderFallbackException

Hay un carácter en el búfer que es un carácter XML válido pero que no es válido para la codificación de salida. Por ejemplo, si la codificación de salida es ASCII, sólo debería utilizar los caracteres del intervalo de 0 a 127 para el elemento y nombres de atributo. El carácter no válido podría estar en el argumento de este método o en un argumento de métodos anteriores que estaban escribiendo en el búfer. Las referencias a entidades de caracteres anulan a dichos caracteres siempre que sea posible (por ejemplo, en nodos de texto o valores de atributo). Sin embargo, la referencia de entidad de carácter no se permite en nombres de elemento y de atributo, comentarios, instrucciones de procesamiento o secciones CDATA.

InvalidOperationException

Se llamó un método XmlWriter antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Ejemplos

En el ejemplo siguiente se usan varios métodos de escritura para crear un fragmento XML.

C#

using System;
using System.IO;
using System.Xml;

 public class Sample
 {
   private const string m_Document = "sampledata.xml";

   public static void Main() {

      XmlWriter writer = null;

      try {

        XmlWriterSettings settings = new XmlWriterSettings();
        settings.Indent = true;
        writer = XmlWriter.Create (m_Document, settings);

        writer.WriteComment("sample XML fragment");

        // Write an element (this one is the root).
        writer.WriteStartElement("book");

        // Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk", null, "urn:samples");

        // Write the genre attribute.
        writer.WriteAttributeString("genre", "novel");

        // Write the title.
        writer.WriteStartElement("title");
        writer.WriteString("The Handmaid's Tale");
        writer.WriteEndElement();

        // Write the price.
        writer.WriteElementString("price", "19.95");

        // Lookup the prefix and write the ISBN element.
        string prefix = writer.LookupPrefix("urn:samples");
        writer.WriteStartElement(prefix, "ISBN", "urn:samples");
        writer.WriteString("1-861003-78");
        writer.WriteEndElement();

        // Write the style element (shows a different way to handle prefixes).
        writer.WriteElementString("style", "urn:samples", "hardcover");

        // Write the close tag for the root element.
        writer.WriteEndElement();

        // Write the XML to file and close the writer.
        writer.Flush();
        writer.Close();
      }

      finally {
        if (writer != null)
           writer.Close();
     }
   }
 }

Comentarios

Para obtener la versión asincrónica de este método, vea WriteElementStringAsync.

WriteElementString(String, String, String, String)

Source:

XmlWriter.cs

Escribe un elemento con el prefijo, nombre local, el URI de espacio de nombres y el valor especificados.

C#

public void WriteElementString (string? prefix, string localName, string? ns, string? value);

Parámetros

prefix

String

Prefijo del elemento.

localName

String

Nombre local del elemento.

ns

String

Identificador URI de espacio de nombres del elemento.

value

String

Valor del elemento.

Excepciones

ArgumentException

El valor localName es null o una cadena vacía.

o bien

Los valores de parámetro no son válidos.

EncoderFallbackException

Hay un carácter en el búfer que es un carácter XML válido pero que no es válido para la codificación de salida. Por ejemplo, si la codificación de salida es ASCII, sólo debería utilizar los caracteres del intervalo de 0 a 127 para el elemento y nombres de atributo. El carácter no válido podría estar en el argumento de este método o en un argumento de métodos anteriores que estaban escribiendo en el búfer. Las referencias a entidades de caracteres anulan a dichos caracteres siempre que sea posible (por ejemplo, en nodos de texto o valores de atributo). Sin embargo, la referencia de entidad de carácter no se permite en nombres de elemento y de atributo, comentarios, instrucciones de procesamiento o secciones CDATA.

InvalidOperationException

Se llamó un método XmlWriter antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Comentarios

Para obtener la versión asincrónica de este método, vea WriteElementStringAsync.