XmlWriter.WriteComment(String) Methode

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XmlWriter.cs

Schreibt beim Überschreiben in einer abgeleiteten Klasse den Kommentar <!--...--> mit dem angegebenen Text.

C#

public abstract void WriteComment(string? text);

Parameter

text

String

Text, der in den Kommentar eingefügt werden soll.

Ausnahmen

ArgumentException

Der Text ergibt kein wohlgeformtes XML-Dokument.

InvalidOperationException

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Beispiele

Im folgenden Beispiel wird eine XML-Datei geschrieben, die ein Buch darstellt.

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();
  }
}

Hinweise

Wenn text entweder null oder String.Emptyist, schreibt diese Methode einen Kommentar ohne Dateninhalt, z. <B. !---->.

Wenn text eine ungültige Sequenz von zwei Bindestrichen "--" enthält, kann entweder XmlWriter ein ArgumentException (XmlTextWriter Objekte) ausgelöst oder ein Leerzeichen zwischen den Bindestrichen "- -" eingefügt werden, sodass der Text ein gültiger XML-Kommentar ist (XmlWriter Objekte, die von der Create -Methode erstellt wurden).

Die asynchrone Version dieser Methode finden Sie unter WriteCommentAsync.

Gilt für: