XmlWriter.WriteString(String) XmlWriter.WriteString(String) XmlWriter.WriteString(String) XmlWriter.WriteString(String) Method

Definition

Schreibt beim Überschreiben in einer abgeleiteten Klasse den angegebenen Textinhalt.When overridden in a derived class, writes the given text content.

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 String String String

Der zu schreibende Text.The text to write.

Ausnahmen

Die Textzeichenfolge enthält ein ungültiges Ersatzzeichenpaar.The text string contains an invalid surrogate pair.

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Beispiele

Im folgenden Beispiel wird ein XML-Knoten geschrieben.The following example writes an XML node.

#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 'Sample

Hinweise

WriteString führt Folgendes aus:WriteString does the following:

  • Die Zeichen &, <, und > werden durch ersetzt &amp;, &lt;, und &gt;bzw.The characters &, <, and > are replaced with &amp;, &lt;, and &gt;, respectively.

  • Das Standardverhalten einer XmlWriter mit Create erstellten ist das Auslösen eines ArgumentException -Werts, wenn versucht wird, Zeichen Werte im Bereich 0x-0x1F zu schreiben (ausgenommen Leerraum Zeichen 0x9, 0xA und 0xD).The default behavior of an XmlWriter created using Create is to throw an ArgumentException when attempting to write character values in the range 0x-0x1F (excluding white space characters 0x9, 0xA, and 0xD). Diese ungültigen XML-Zeichen können durch Erstellen von XmlWriter erstellt werden CheckCharacters , wobei die false-Eigenschaft auf festgelegt ist.These invalid XML characters can be written by creating the XmlWriter with the CheckCharacters property set to false. Dies führt dazu, dass die Zeichen durch numerische Zeichen Entitäten (&#0; bis & #0x1f) ersetzt werden.Doing so will result in the characters being replaced with numeric character entities (&#0; through &#0x1F). Außerdem ersetzt eine XmlTextWriter mit dem new -Operator erstellte ungültige Zeichen standardmäßig durch numerische Zeichen Entitäten.Additionally, an XmlTextWriter created with the new operator will replace the invalid characters with numeric character entities by default.

Hinweis Microsoft ermutigt nicht, ungültige XML-Zeichen zu schreiben, da viele Anwendungen, die XML verwenden, nicht für das verarbeiten ungültiger Zeichen konzipiert sind.Note Microsoft does not encourage the practice of writing invalid XML characters since many applications that consume XML are not designed to handle invalid characters.

  • Wenn WriteString heißt im Kontext eines Attributwerts durch doppelte und einfache Anführungszeichen ersetzt &quot; und &apos; bzw.If WriteString is called in the context of an attribute value, double and single quotes are replaced with &quot; and &apos; respectively.

Diese Eingabe Zeichenfolge test<item>test wird beispielsweise alsFor example, this input string test<item>test is written out as

test&lt;item&gt;test  

Wenn text entweder null oderString.Emptyist, schreibt diese Methode einen Textknoten ohne Dateninhalt.If text is either null or String.Empty, this method writes a text node with no data content.

Die asynchrone Version dieser Methode finden WriteStringAsyncSie unter.For the asynchronous version of this method, see WriteStringAsync.

Gilt für: