Teilen über


XmlWriter.WriteString(String) Methode

Definition

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

public:
 abstract void WriteString(System::String ^ text);
public abstract void WriteString (string text);
public abstract void WriteString (string? text);
abstract member WriteString : string -> unit
Public MustOverride Sub WriteString (text As String)

Parameter

text
String

Der zu schreibende Text.

Ausnahmen

Die Textzeichenfolge enthält ein ungültiges Ersatzzeichenpaar.

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 ein XML-Knoten geschrieben.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create a writer to write XML to the console.
   XmlWriterSettings^ settings = gcnew XmlWriterSettings;
   settings->Indent = true;
   settings->OmitXmlDeclaration = true;
   XmlWriter^ writer = XmlWriter::Create( Console::Out, settings );
   
   // Write the book element.
   writer->WriteStartElement( L"book" );
   
   // Write the title element.
   writer->WriteStartElement( L"title" );
   writer->WriteString( L"Pride And Prejudice" );
   writer->WriteEndElement();
   
   // Write the close tag for the root element.
   writer->WriteEndElement();
   
   // Write the XML and close the writer.
   writer->Close();
   return 1;
}
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();
  }
}
Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
  Public Shared Sub Main()

     ' Create a writer to write XML to the console.
     Dim settings As XmlWriterSettings = new XmlWriterSettings()
     settings.Indent = true
     settings.OmitXmlDeclaration = true
     Dim writer As XmlWriter = 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()

  End Sub
End Class

Hinweise

WriteString führt Folgendes aus:

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

  • Das Standardverhalten eines XmlWriter erstellten mit Create -Elements besteht darin, eine ArgumentException auszulösen, wenn versucht wird, Zeichenwerte im Bereich 0x-0x1F zu schreiben (ausgenommen Leerzeichen 0x9, 0xA und 0xD). Diese ungültigen XML-Zeichen können durch Erstellen von geschrieben werden, wobei die XmlWriterCheckCharacters -Eigenschaft auf falsefestgelegt ist. Dies führt dazu, dass die Zeichen durch numerische Zeichenentitäten ersetzt werden (� bis �x1F). Darüber hinaus ersetzt ein XmlTextWriter mit dem new -Operator erstelltes die ungültigen Zeichen standardmäßig durch numerische Zeichenentitäten.

Hinweis Microsoft empfiehlt das Schreiben ungültiger XML-Zeichen nicht, da viele Anwendungen, die XML nutzen, nicht für die Verarbeitung ungültiger Zeichen konzipiert sind.

  • Wenn WriteString heißt im Kontext eines Attributwerts durch doppelte und einfache Anführungszeichen ersetzt &quot; und &apos; bzw.

Diese Eingabezeichenfolge test<item>test wird z. B. als

test<item>test

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

Die asynchrone Version dieser Methode finden Sie unter WriteStringAsync.

Gilt für: