XmlWriter.WriteString(String) Methode

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XmlWriter.cs

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der angegebene Textinhalt geschrieben.

public:
 abstract void WriteString(System::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

ArgumentException

Die Textzeichenfolge enthält ein ungültiges Ersatzpaar.

InvalidOperationException

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

Beispiele

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

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 die folgenden Aktionen aus:

• Die Zeichen &, <, und > werden durch &, <und >, bzw. ersetzt.

• Das Standardverhalten einer XmlWriter erstellten Verwendung Create besteht darin, ArgumentException beim Versuch, Zeichenwerte im Bereich 0x-0x1F zu schreiben (mit Ausnahme von Leerzeichen 0x9, 0xA und 0xD). Diese ungültigen XML-Zeichen können geschrieben werden, indem sie die XmlWriter Eigenschaft erstellen, auf falsedie CheckCharacters die Eigenschaft festgelegt ist. Dadurch werden die Zeichen durch numerische Zeichenentitäten ersetzt (� bis �x1F). Darüber hinaus ersetzt ein XmlTextWriter mit dem new Operator erstelltes Zeichen standardmäßig die ungültigen Zeichen durch numerische Zeichenentitäten.

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

• Wird WriteString im Kontext eines Attributwerts aufgerufen, werden doppelte und einzelne Anführungszeichen durch " bzw ' . ersetzt.

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

test<item>test

Ist text dies der null Fall, String.Emptyschreibt diese Methode einen Textknoten ohne Dateninhalt.

Die asynchrone Version dieser Methode finden Sie unter WriteStringAsync.