XmlWriter.WriteString(String) Methode

Definitie

Naamruimte:
System.Xml
Assembly's:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
netstandard.dll

Wanneer deze wordt overschreven in een afgeleide klasse, schrijft u de opgegeven tekstinhoud.

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)

Parameters

text
String

De te schrijven tekst.

Uitzonderingen

ArgumentException

De tekenreeks bevat een ongeldig surrogaatpaar.

InvalidOperationException

Er XmlWriter is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

Voorbeelden

In het volgende voorbeeld wordt een XML-knooppunt geschreven.

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

Opmerkingen

WriteString doet het volgende:

  • De tekens &, <en > worden vervangen &amp;door respectievelijk , &lt;en &gt;.

  • Het standaardgedrag van een XmlWriter gemaakt gebruik Create is om een ArgumentException tekenwaarden te schrijven in het bereik van 0x-0x1F (met uitzondering van spatietekens 0x9, 0xA en 0xD). Deze ongeldige XML-tekens kunnen worden geschreven door de XmlWriterCheckCharacters eigenschap te maken die is ingesteld op false. Als u dit doet, worden de tekens vervangen door numerieke tekenentiteiten (� tot en met �x1F). Bovendien vervangt een XmlTextWriter gemaakt met de new operator de ongeldige tekens standaard door numerieke tekenentiteiten.

Note Microsoft moedigt het schrijven van ongeldige XML-tekens niet aan, omdat veel toepassingen die XML gebruiken, niet zijn ontworpen om ongeldige tekens te verwerken.

  • Als WriteString deze wordt aangeroepen in de context van een kenmerkwaarde, worden dubbele en enkele aanhalingstekens vervangen door &quot; respectievelijk &apos; .

Deze invoertekenreeks test<item>test wordt bijvoorbeeld weggeschreven als

test<item>test

Als text dat het geval null is of String.Empty, schrijft deze methode een tekstknooppunt zonder gegevensinhoud.

Zie voor de asynchrone versie van deze methode WriteStringAsync.

Van toepassing op