XmlTextWriter.WriteString(String) Methode

Definitie

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

Hiermee schrijft u de opgegeven tekstinhoud.

public:
 override void WriteString(System::String ^ text);
public override void WriteString(string? text);
public override void WriteString(string text);
override this.WriteString : string -> unit
Public Overrides Sub WriteString (text As String)

Parameters

text
String

Te schrijven tekst.

Uitzonderingen

ArgumentException

De tekenreeks bevat een ongeldig surrogaatpaar.

Voorbeelden

In het volgende voorbeeld wordt een XML-fragment 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.
     XmlTextWriter writer = null;
     writer = new XmlTextWriter (Console.Out);

     //Use indentation for readability.
     writer.Formatting = Formatting.Indented;
     writer.Indentation = 4;

     //Write an element (this one is the root).
     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 to file 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 writer As XmlTextWriter = Nothing
        writer = New XmlTextWriter(Console.Out)
        
        'Use indentation for readability.
        writer.Formatting = Formatting.Indented
        writer.Indentation = 4
        
        'Write an element (this one is the root).
        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 to file and close the writer.
        writer.Close()
    End Sub
End Class

Opmerkingen

Note

U wordt aangeraden om XmlWriter-exemplaren te maken met behulp van de XmlWriter.Create-methode en de XmlWriterSettings-klasse om te profiteren van nieuwe functionaliteit.

WriteString doet het volgende

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

  • Tekenwaarden in het bereik 0x-0x1F (met uitzondering van spatietekens 0x9, 0xA en 0xD) worden vervangen door numerieke tekenentiteiten (&#0; via &#0x1F).

  • 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 is bijvoorbeeld geschreven als test&lt;item&gt;test.

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

Van toepassing op