XmlTextWriter.WriteString(String) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlTextWriter.cs

Menulis konten teks yang diberikan.

public:
 override void WriteString(System::String ^ text);

public override void WriteString(string? text);

override this.WriteString : string -> unit

Public Overrides Sub WriteString (text As String)

Parameter

text

String

Teks untuk ditulis.

Pengecualian

ArgumentException

String teks berisi pasangan pengganti yang tidak valid.

Contoh

Contoh berikut menulis fragmen XML.

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

Keterangan

Note

Kami menyarankan agar Anda membuat XmlWriter instans dengan menggunakan XmlWriter.Create metode dan XmlWriterSettings kelas untuk memanfaatkan fungsionalitas baru.

WriteString melakukan hal berikut

• Karakter , , dan & masing-masing diganti dengan <, >, dan &. <>

• Nilai karakter dalam rentang 0x-0x1F (tidak termasuk karakter spasi putih 0x9, 0xA, dan 0xD) diganti dengan entitas karakter numerik (� melalui &#0x1F).

• Jika WriteString dipanggil dalam konteks nilai atribut, tanda kutip ganda dan tunggal diganti dengan " dan ' masing-masing.

Misalnya, string test<item>test input ini ditulis sebagai test<item>test.

Jika text adalah null atau String.Empty, metode ini menulis simpul teks tanpa konten data.