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.WriteString-Methode: (String)

 

Veröffentlicht: Oktober 2016

Schreibt beim Überschreiben in einer abgeleiteten Klasse den angegebenen Textinhalt.

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

public abstract void WriteString(
	string text
)

Parameter

text
Type: System.String

Der zu schreibende Text.

Exception Condition
ArgumentException

Die Zeichenfolge enthält ein ungültiges Ersatzzeichenpaar.

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."

WriteString führt Folgendes aus:

  • Die Zeichen &, <, und > mit ersetzt &amp;, &lt;, und &gt;, bzw..

  • Das Standardverhalten von einer XmlWriter mit erstellt Create ausgelöst wird eine ArgumentException beim Zeichenwerte im Bereich 0-x-0x1F (außer den Leerraumzeichen 0 x 9, 0xA und 0xD) zu schreiben. Diese ungültigen XML-Zeichen können geschrieben werden, durch das Erstellen der XmlWriter mit der CheckCharacters Eigenschaft festgelegt, um false. Dadurch werden die Zeichen durch numerische Zeichenentitäten ersetzt (&#0; bis & #0x1F). Darüber hinaus ein XmlTextWriter erstellt, mit der new Operator ersetzt die ungültigen Zeichen durch numerische Zeichenentitäten standardmäßig.

Hinweis   Microsoft ist nicht empfiehlt, ungültige XML-Zeichen schreiben, da viele Clientanwendungen, die XML zu verwenden, sind nicht zur Verarbeitung von ungültiger Zeichen.

  • Wenn WriteString aufgerufen wird im Kontext eines Attributwerts, werden doppelte und einfache Anführungszeichen durch ersetzt &quot; und &apos; bzw..

Z. B. Eingabezeichenfolge test<item>test als geschrieben wird

test&lt;item&gt;test

Wenn text ist entweder null oder String.Empty, schreibt diese Methode einen Textknoten ohne Dateninhalt.

Die asynchrone Version dieser Methode finden Sie unter WriteStringAsync.

Das folgende Beispiel schreibt einen XML-Knoten.

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

public class Sample {

  public static void Main() {

     // Create a writer to write XML to the console.
     XmlWriterSettings settings = new XmlWriterSettings();
     settings.Indent = true;
     settings.OmitXmlDeclaration = true;
     XmlWriter writer = XmlWriter.Create(Console.Out, settings);

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

     // Write the title element.
     writer.WriteStartElement("title");
     writer.WriteString("Pride And Prejudice");
     writer.WriteEndElement();

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

     // Write the XML and close the writer.
     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: