Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

XmlWriter.WriteComment-Methode: (String)

 

Veröffentlicht: Oktober 2016

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

Namespace:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public abstract void WriteComment(
	string text
)

Parameter

text
Type: System.String

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

Exception Condition
ArgumentException

Der Text ergibt kein XML-Dokument nicht wohlgeformt.

InvalidOperationException

Eine XmlWriter Methode wurde aufgerufen, bevor der vorherige asynchroner Vorgang abgeschlossen. In diesem Fall InvalidOperationException wird ausgelöst, mit der Meldung "ein asynchroner Vorgang ist bereits in Bearbeitung."

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

Wenn text enthält eine ungültige Sequenz von zwei Gedankenstrichen "--" der XmlWriter können entweder Throw ein ArgumentException (XmlTextWriter Objekte) oder ein Leerzeichen zwischen den Gedankenstrichen einfügen "- -" so, dass der Text ein gültiger XML-Kommentar (XmlWriter Objekte erstellt, indem die Create Methode).

Die asynchrone Version dieser Methode finden Sie unter WriteCommentAsync.

Das folgende Beispiel schreibt eine XML-Datei, die ein Buch darstellt.

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

}

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: