War diese Seite hilfreich?
Ihr Feedback ist uns wichtig. Teilen Sie uns Ihre Meinung mit.
Weiteres Feedback?
1500 verbleibende Zeichen
Exportieren (0) Drucken
Alle erweitern
Erweitern Minimieren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

XmlWriter.WriteString-Methode

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
Typ: System.String
Der zu schreibende Text.

AusnahmeBedingung
ArgumentException

Die Textzeichenfolge enthält ein ungültiges Ersatzzeichenpaar.

InvalidOperationException

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

WriteString führt Folgendes aus:

  • Die Zeichen &, < und > werden jeweils durch &amp;, &lt; und &gt; ersetzt.

  • Das Standardverhalten eines mit Create erstellten XmlWriter besteht darin, eine ArgumentException auszulösen, wenn versucht wird, Zeichenwerte im Bereich 0x-0x1F (außer den Leerzeichen 0x9, 0xA und 0xD) zu schreiben. Diese ungültigen XML-Zeichen können geschrieben werden, indem Sie beim Erstellen des XmlWriter die CheckCharacters-Eigenschaft auf false festlegen. Dadurch werden die Zeichen durch numerische Zeichenentitäten ersetzt (&#0; bis #0x1F). Darüber hinaus ersetzt ein mit dem Operator new erstellter XmlTextWriter die ungültigen Zeichen in der Standardeinstellung durch numerische Zeichenentitäten.

Hinweis   Das Schreiben ungültiger Zeichen wird von Microsoft nicht empfohlen, da viele Anwendungen, die XML verwenden, nicht für das Behandeln ungültiger Zeichen ausgelegt sind.

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

Die Eingabezeichenfolge test<item>test wird z. B. wie folgt geschrieben.

 test&lt;item&gt;test

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

Für die asynchrone Version dieser Methode, finden Sie unter WriteStringAsync.

Im folgenden Beispiel wird ein XML-Knoten geschrieben.


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

  }
}


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft