XmlWriter.WriteComment(String) Método

Definición

Espacio de nombres:

System.Xml

Ensamblados:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

Cuando se invalida en una clase derivada, escribe un comentario <!--...--> que contiene el texto especificado.

C#

public abstract void WriteComment(string? text);

Parámetros

text

String

Texto que se va a colocar en el comentario.

Excepciones

ArgumentException

El texto daría como resultado un documento XML con formato incorrecto.

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 escribe un archivo XML que representa un libro.

C#

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

public class Sample {

  private const string filename = "sampledata.xml";

  public static void Main() {

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

     // Write the Processing Instruction node.
     String PItext="type=\"text/xsl\" href=\"book.xsl\"";
     writer.WriteProcessingInstruction("xml-stylesheet", PItext);

     // Write the DocumentType node.
     writer.WriteDocType("book", null , null, "<!ENTITY h \"hardcover\">");

     // Write a Comment node.
     writer.WriteComment("sample XML");

     // Write the root element.
     writer.WriteStartElement("book");

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

     // Write the ISBN attribute.
     writer.WriteAttributeString("ISBN", "1-8630-014");

     // Write the title.
     writer.WriteElementString("title", "The Handmaid's Tale");

     // Write the style element.
     writer.WriteStartElement("style");
     writer.WriteEntityRef("h");
     writer.WriteEndElement();

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

     // Write CDATA.
     writer.WriteCData("Prices 15% off!!");

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

     writer.WriteEndDocument();

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

Comentarios

Si text es null o String.Empty, este método escribe un comentario sin contenido de datos, por ejemplo <, !---->.

Si text contiene una secuencia no válida de dos guiones "--", XmlWriter puede iniciar un ArgumentException (XmlTextWriter objetos) o insertar un espacio entre los guiones "- -" para que el texto sea un comentario XML válido (XmlWriter objetos creados por el Create método ).

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

Se aplica a